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