Función DestroyMenu (winuser.h)

Artículo
08/27/2023

Destruye el menú especificado y libera toda memoria que ocupe el menú.

Sintaxis

BOOL DestroyMenu(
  [in] HMENU hMenu
);

Parámetros

[in] hMenu

Tipo: HMENU

Identificador del menú que se va a destruir.

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.

Comentarios

Antes de cerrar, una aplicación debe usar la función DestroyMenu para destruir un menú no asignado a una ventana. Un menú asignado a una ventana se destruye automáticamente cuando se cierra la aplicación.

DestroyMenu es recursivo, es decir, destruirá el menú y todos sus submenús.

Ejemplos

Para obtener un ejemplo, vea Mostrar un menú contextual.

Requisitos


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-menu-l1-1-0 (introducido en Windows 8)