Compartir a través de

Método IAccPropServices::D ecomposeHmenuIdentityString (oleacc.h)

  • Artículo

Use este método para determinar el HMENU, el identificador de objeto y el identificador secundario para el elemento accesible identificado por la cadena de identidad.

Sintaxis

HRESULT DecomposeHmenuIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HMENU      *phmenu,
  [out] DWORD      *pidChild
);

Parámetros

[in] pIDString

Tipo: const BYTE*

Puntero a un búfer que contiene la cadena de identidad de un elemento accesible basado en HMENU.

[in] dwIDStringLen

Tipo: DWORD

Especifica la longitud de la cadena de identidad especificada por pIDString.

[out] phmenu

Tipo: HMENU*

Puntero a un búfer que recibe el HMENU del elemento accesible.

[out] pidChild

Tipo: DWORD*

Puntero a un búfer que recibe el id. secundario del elemento accesible.

Valor devuelto

Tipo: HRESULT

Si se ejecuta correctamente, devuelve S_OK.

Devuelve E_INVALIDARG si phmenu o pidChild no son válidos, o si la cadena de identidad especificada no es una cadena de identidad basada en HMENU.

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

Comentarios

Este método solo se realiza correctamente si la cadena de identidad proporcionada es una cadena de identidad basada en HMENU. Este método es útil en un servidor de devolución de llamada IAccPropServer que se registró con ANNO_CONTAINER ámbito porque permite al servidor determinar, desde la cadena de identidad especificada, el elemento secundario (idChild) para el que el cliente llama al servidor.

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