LoadResource 函式 (libloaderapi.h)

發行項
02/28/2024

擷取句柄，這個句柄可用來取得記憶體中指定資源之第一個字節的指標。

語法

HGLOBAL LoadResource(
  [in, optional] HMODULE hModule,
  [in]           HRSRC   hResInfo
);

參數

[in, optional] hModule

類型： HMODULE

模組的句柄，其可執行檔包含資源。如果 hModule 為 NULL，系統會從用來建立目前進程的模組載入資源。

[in] hResInfo

類型： HRSRC

要載入之資源的句柄。 FindResource 或 FindResourceEx 函式會傳回此句柄。

傳回值

類型： HGLOBAL

如果函式成功，傳回值就是與資源相關聯的數據句柄。

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

備註

LoadResource 的傳回型別為 HGLOBAL 以供回溯相容性，而不是因為函式會傳回全域記憶體區塊的句柄。請勿將此句柄傳遞至 GlobalLock 或 GlobalFree 函式。若要取得資源數據第一個字節的指標，請呼叫 LockResource 函式;若要取得資源的大小，請呼叫 SizeofResource。

GlobalSize 會針對資源 HGLOBAL 傳回 0。因此，依賴 GlobalSize 來判斷 HGLOBAL 大小的任何 API 都不會正確運作。例如，使用 SHCreateMemStream ，而不是 CreateStreamOnHGlobal。

若要立即使用資源，應用程式應該使用下列資源特定的函式，在一次呼叫中尋找並載入資源。

函式	動作	拿掉資源
FormatMessage	載入和格式化消息表專案	不需採取動作
LoadAccelerators	載入快速鍵數據表	DestroyAcceleratorTable
LoadBitmap	載入點圖資源	DeleteObject
LoadCursor	載入數據指標資源	DestroyCursor
LoadIcon	載入圖示資源	DestroyIcon
LoadMenu	載入功能表資源	DestroyMenu
LoadString	載入字串資源	不需採取動作

例如，應用程式可以使用 LoadIcon 函式，在完成時載入圖示來顯示在螢幕上，後面接著 DestroyIcon 。

範例

如需範例，請參閱更新資源。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	libloaderapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll