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

Les appelants utilisent ComposeHwndIdentityString pour récupérer une chaîne d’identité.

Syntaxe

HRESULT ComposeHwndIdentityString(
  [in]  HWND  hwnd,
  [in]  DWORD idObject,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Paramètres

[in] hwnd

Type : HWND

Spécifie le HWND de l’élément accessible que l’appelant souhaite identifier.

[in] idObject

Type : DWORD

Spécifie l'ID d'objet de l'élément accessible.

[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 hwnd, idObject 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