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

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é.

• IAccPropServices::SetHwndPropStr
• IAccPropServices::SetHwndProp
• IAccPropServices::SetHwndPropServer

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