Méthode IAccIdentity::GetIdentityString (oleacc.h)

Article
08/25/2023

Récupère une chaîne d’octets (chaîne d’identité) qui identifie de façon unique un élément accessible.

Si les développeurs de serveurs connaissent le HWND de l’objet qu’ils souhaitent annoter, ils peuvent utiliser l’une des méthodes suivantes au lieu d’utiliser cette méthode et d’obtenir une chaîne d’identité.

Syntaxe

HRESULT GetIdentityString(
  [in]  DWORD dwIDChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Paramètres

[in] dwIDChild

Type : DWORD

Spécifie l’enfant de l’objet IAccessible que l’appelant souhaite identifier.

[out] ppIDString

Type : BYTE**

Adresse d'une variable qui reçoit un pointeur vers une chaîne d'identité allouée par l'appelé. L’appelé alloue la chaîne d’identité à l’aide de CoTaskMemAlloc ; L’appelant doit libérer la chaîne d’identité à l’aide de CoTaskMemFree lorsque vous avez terminé.

[out] pdwIDStringLen

Type : DWORD*

Adresse d'une variable qui reçoit la longueur, en octets, de la chaîne d'identité allouée par l'appelé.

Valeur retournée

Type : HRESULT

Retournez S_OK, sauf dans des conditions d’erreur exceptionnelles, telles qu’une mémoire insuffisante. S’il n’est pas pris en charge, l’appel de QueryInterface sur IAccIdentity doit échouer.

Notes

La chaîne retournée doit être considérée comme opaque ; les clients ne doivent l’utiliser que dans son ensemble et ne doivent pas tenter de le disséquer ou de l’interpréter manuellement.

Si un client sait ou s’attend à ce qu’une chaîne soit basée sur HWND, il peut utiliser IAccPropServices::D ecomposeHwndIdentityString pour tenter de décomposer la chaîne d’identité.

Spécifications


Client minimal pris en charge	Windows Vista ou Windows XP
Serveur minimal pris en charge	Windows Server 2003
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

Partager via