Méthode IAccPropServices ::ComposeHmenuIdentityString (oleacc.h)

Les appelants utilisent ComposeHmenuIdentityString pour récupérer une chaîne d’identité pour un élément accessible basé sur HMENU.

Syntaxe

HRESULT ComposeHmenuIdentityString(
  [in]  HMENU hmenu,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Paramètres

[in] hmenu

Type : HMENU

Identifie l’élément accessible basé sur HMENU.

[in] idChild

Type : DWORD

Spécifie l'ID enfant de l'élément accessible.

[out] ppIDString

Type : BYTE**

Pointeur vers une mémoire tampon qui reçoit la chaîne d'identité. L’appelé alloue cette mémoire tampon à l’aide de CoTaskMemAlloc. Lorsque vous avez terminé, l’appelant doit libérer la mémoire tampon en appelant CoTaskMemFree.

[out] pdwIDStringLen

Type : DWORD*

Pointeur vers une mémoire tampon qui reçoit la longueur de la chaîne d'identité.

Valeur retournée

Type : HRESULT

En cas de réussite, retourne S_OK.

Retourne E_INVALIDARG si hmenu ou idChild n’est pas valide.

Peut retourner d’autres codes d’erreur dans des conditions d’erreur exceptionnelles, telles qu’une mémoire insuffisante.

Configuration requise