Função DestroyMenu (winuser.h)

Artigo
08/27/2023

Destrói o menu especificado e libera qualquer memória que o menu ocupa.

Sintaxe

BOOL DestroyMenu(
  [in] HMENU hMenu
);

Parâmetros

[in] hMenu

Tipo: HMENU

Um identificador para o menu a ser destruído.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Antes de fechar, um aplicativo deve usar a função DestroyMenu para destruir um menu não atribuído a uma janela. Um menu atribuído a uma janela é destruído automaticamente quando o aplicativo é fechado.

DestroyMenu é recursivo, ou seja, destruirá o menu e todo o seu submenu.

Exemplos

Para obter um exemplo, consulte Exibindo um menu de atalho.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll
Conjunto de APIs	ext-ms-win-ntuser-menu-l1-1-0 (introduzido no Windows 8)