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