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

Los autores de llamadas usan ComposeHmenuIdentityString para recuperar una cadena de identidad para un elemento accesible basado en HMENU.

Sintaxis

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

Parámetros

[in] hmenu

Tipo: HMENU

Identifica el elemento accesible basado en HMENU.

[in] idChild

Tipo: DWORD

Especifica el id. secundario del elemento accesible.

[out] ppIDString

Tipo: BYTE**

Puntero a un búfer que recibe la cadena de identidad. El destinatario asigna este búfer mediante CoTaskMemAlloc. Cuando termine, el autor de la llamada debe liberar el búfer llamando a CoTaskMemFree.

[out] pdwIDStringLen

Tipo: DWORD*

Puntero a un búfer que recibe la longitud de la cadena de identidad.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Devuelve E_INVALIDARG si hmenu o idChild no es válido.

Puede devolver otros códigos de error en condiciones de error excepcionales, como memoria baja.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado oleacc.h (incluya OleAcc.h Include Initguid.h first).
Archivo DLL Oleacc.dll
Redistribuible RDK de accesibilidad activa 2.0 en Windows NT 4.0 con SP6 y versiones posteriores y Windows 98