Metodo IAccPropServices::ComposeHwndIdentityString (oleacc.h)

I chiamanti usano ComposeHwndIdentityString per recuperare una stringa di identità.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Specifica il valore HWND dell'elemento accessibile che il chiamante vuole identificare.

[in] idObject

Tipo: DWORD

Specifica l'ID di oggetto dell'elemento accessibile.

[in] idChild

Tipo: DWORD

Specifica l'ID figlio dell'elemento accessibile.

[out] ppIDString

Tipo: BYTE**

Puntatore a un buffer che riceve la stringa di identità. Il chiamante alloca questo buffer usando CoTaskMemAlloc. Al termine, il chiamante deve liberare il buffer chiamando CoTaskMemFree.

[out] pdwIDStringLen

Tipo: DWORD*

Puntatore a un buffer che riceve la lunghezza della stringa di identità.

Valore restituito

Tipo: HRESULT

Se ha esito positivo, restituisce S_OK.

Restituisce E_INVALIDARG se hwnd, idObject o idChild non è valido.

Può restituire altri codici di errore in condizioni di errore eccezionali, ad esempio bassa memoria.

Requisiti