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

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h (incluez d’abord OleAcc.h Inclure Initguid.h))
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 2.0 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 98