擷取句柄,這個句柄可用來取得記憶體中指定資源第一個字節的指標。
語法
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 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
頁首 | libloaderapi.h (包括 Windows.h) |
程式庫 | 內核 32.lib |
DLL | Kernel32.dll |