Compartilhar via

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

  • Artigo

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

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho oleacc.h (inclua OleAcc.h Incluir Initguid.h primeiro.)
DLL Oleacc.dll
Redistribuível Active Accessibility 2.0 RDK no Windows NT 4.0 com SP6 e posterior e Windows 98