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

Os chamadores usam ComposeHmenuIdentityString para recuperar uma cadeia de caracteres de identidade para um elemento acessível baseado em HMENU.

Sintaxe

HRESULT ComposeHmenuIdentityString(
  [in]  HMENU hmenu,
  [in]  DWORD idChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Parâmetros

[in] hmenu

Tipo: HMENU

Identifica o elemento acessível baseado em HMENU.

[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 computador chamado aloca esse buffer usando CoTaskMemAlloc. Quando terminar, o chamador deverá 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 hmenu ou idChild não for válido.

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

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