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

Os chamadores usam ComposeHwndIdentityString para recuperar uma cadeia de caracteres de identidade.

Sintaxe

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

Parâmetros

[in] hwnd

Tipo: HWND

Especifica o HWND do elemento acessível que o chamador deseja identificar.

[in] idObject

Tipo: DWORD

Especifica a ID do objeto do elemento acessível.

[in] idChild

Tipo: DWORD

Especifica a ID do filho do elemento acessível.

[out] ppIDString

Tipo: BYTE**

Ponteiro para um buffer que recebe a cadeia de caracteres de identidade. O destinatário do chamado aloca esse buffer usando CoTaskMemAlloc. Quando terminar, o chamador deve liberar o buffer chamando CoTaskMemFree.

[out] pdwIDStringLen

Tipo: DWORD*

Ponteiro para um buffer que recebe o comprimento da cadeia de caracteres de identidade.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Retorna E_INVALIDARG se hwnd, idObject ou idChild não for válido.

Pode retornar outros códigos de erro em condições de erro excepcionais, como memória baixa.

Requisitos