Metodo IAccIdentity::GetIdentityString (oleacc.h)

Articolo
03/08/2023

Recupera una stringa di byte (stringa di identità) che identifica in modo univoco un elemento accessibile.

Se gli sviluppatori di server conoscono il valore HWND dell'oggetto da annotare, possono usare uno dei metodi seguenti anziché usare questo metodo e ottenere una stringa di identità.

Sintassi

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

Parametri

[in] dwIDChild

Tipo: DWORD

Specifica quale elemento figlio dell'oggetto IAccessible il chiamante desidera identificare.

[out] ppIDString

Tipo: BYTE**

Indirizzo di una variabile che riceve un puntatore a una stringa di identità allocata dal chiamato. Il chiamato alloca la stringa di identità usando CoTaskMemAlloc; Il chiamante deve rilasciare la stringa di identità usando CoTaskMemFree al termine.

[out] pdwIDStringLen

Tipo: DWORD*

Indirizzo di una variabile che riceve la lunghezza, in byte, della stringa di identità allocata dal chiamato.

Valore restituito

Tipo: HRESULT

Restituisce S_OK, ad eccezione di condizioni di errore eccezionali, ad esempio memoria insufficiente. Se non è supportato, la chiamata a QueryInterface in IAccIdentity avrà esito negativo.

Commenti

La stringa restituita deve essere considerata opaca; i client devono usarlo solo nel suo complesso e non devono tentare di analizzarlo o interpretarlo manualmente.

Se un client conosce o prevede che una stringa sia basata su HWND, può usare IAccPropServices::D ecomposeHwndIdentityString per tentare di scomporre la stringa di identità.

Requisiti


Client minimo supportato	Windows Vista o Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	oleacc.h (include OleAcc.h Include Initguid.h first.)
DLL	Oleacc.dll
Componente ridistribuibile	Active Accessibility 2.0 RDK in Windows NT 4.0 con SP6 e versioni successive e Windows 98

Condividi tramite