Partager via

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

  • Article

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