Función GetMenuBarInfo (winuser.h)

Artículo
03/04/2024

Recupera información sobre la barra de menú especificada.

Sintaxis

BOOL GetMenuBarInfo(
  [in]      HWND         hwnd,
  [in]      LONG         idObject,
  [in]      LONG         idItem,
  [in, out] PMENUBARINFO pmbi
);

Parámetros

[in] hwnd

Tipo: HWND

Identificador de la ventana (barra de menús) cuya información se va a recuperar.

[in] idObject

Tipo: LONG

Objeto de menú. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
OBJID_CLIENT ((LONG)0xFFFFFFFC)	Menú emergente asociado a la ventana.
OBJID_MENU ((LONG)0xFFFFFFFD)	Barra de menús asociada a la ventana (vea la función GetMenu ).
OBJID_SYSMENU ((LONG)0xFFFFFFFF)	El menú del sistema asociado a la ventana (vea la función GetSystemMenu ).

[in] idItem

Tipo: LONG

Elemento para el que se va a recuperar información. Si este parámetro es cero, la función recupera información sobre el propio menú. Si este parámetro es 1, la función recupera información sobre el primer elemento del menú, y así sucesivamente.

[in, out] pmbi

Tipo: PMENUBARINFO

Puntero a una estructura MENUBARINFO que recibe la información. Tenga en cuenta que debe establecer el miembro cbSize en sizeof(MENUBARINFO) antes de llamar a esta función.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-misc-l1-5-0 (introducido en Windows 10, versión 10.0.10240)

Consulte también

Conceptual

Referencia