共用方式為


LoadResource 函式 (libloaderapi.h)

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

語法

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

參數

[in, optional] hModule

類型:HMODULE

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

[in] hResInfo

類型: HRSRC

要載入之資源的句柄。 此句柄是由 FindResourceFindResourceEx 函式傳回。

返回值

類型: HGLOBAL

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

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

備註

LoadResource 的傳回類型是 HGLOBAL,以提供回溯相容性,而不是因為函式會傳回全域記憶體區塊的句柄。 請勿將此句柄傳遞至 GlobalLockGlobalFree 函式。 若要取得資源數據第一個字節的指標,請呼叫 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

另請參閱

FindResource

FindResourceEx

LoadLibrary

LoadModule

LockResource