Função LoadMenuA (winuser.h)

Artigo
08/27/2023

Carrega o recurso de menu especificado do arquivo executável (.exe) associado a uma instância de aplicativo.

Sintaxe

HMENU LoadMenuA(
  [in, optional] HINSTANCE hInstance,
  [in]           LPCSTR    lpMenuName
);

Parâmetros

[in, optional] hInstance

Tipo: HINSTANCE

Um identificador para o módulo que contém o recurso de menu a ser carregado.

[in] lpMenuName

Tipo: LPCTSTR

O nome do recurso de menu. Como alternativa, esse parâmetro pode consistir no identificador de recurso na palavra de baixa ordem e zero na palavra de alta ordem. Para criar esse valor, use a macro MAKEINTRESOURCE .

Retornar valor

Tipo: HMENU

Se a função for bem-sucedida, o valor retornado será um identificador para o recurso de menu.

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

Comentários

A função DestroyMenu é usada, antes do fechamento de um aplicativo, para destruir o menu e a memória livre que o menu carregado ocupava.

Exemplos

Para obter um exemplo, consulte Exibindo um menu de atalho

Observação

O cabeçalho winuser.h define LoadMenu como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
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-3 (introduzido no Windows 10, versão 10.0.14393)