LoadMenuA 函式 (winuser.h)

  • 發行項

從與應用程式實例相關聯的可執行檔 (.exe) 檔案載入指定的功能表資源。

語法

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

參數

[in, optional] hInstance

類型： HINSTANCE

模組的句柄，其中包含要載入的功能表資源。

[in] lpMenuName

類型： LPCTSTR

功能表資源的名稱。 或者，此參數可以包含低序字中的資源標識符，並以高序單字組成零。 若要建立此值，請使用 MAKEINTRESOURCE 宏。

傳回值

類型： HMENU

如果函式成功，則傳回值是功能表資源的句柄。

如果函式失敗，則傳回值為 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

在應用程式關閉之前， 會使用DestroyMenu 函式來終結功能表，並釋放載入功能表佔用的記憶體。

範例

如需範例，請參閱 顯示快捷方式功能表

注意

winuser.h 標頭會將 LoadMenu 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-menu-l1-1-3 (於 Windows 10 10.0.14393 版)

另請參閱

概念

LoadMenuIndirect

MAKEINTRESOURCE

功能表

參考