LockResource 函式 (libloaderapi.h)

  • 發行項

擷取記憶體中指定資源的指標。

語法

LPVOID LockResource(
  [in] HGLOBAL hResData
);

參數

[in] hResData

類型： HGLOBAL

要存取之資源的控制碼。 LoadResource 函式會傳回這個控制碼。 請注意，此參數只會列為 HGLOBAL 變數，以取得回溯相容性。 請勿將任何值當做 來自 LoadResource 函式成功傳回值以外的參數傳遞。

傳回值

類型： LPVOID

如果載入的資源可用，傳回值就是資源第一個位元組的指標;否則為 Null。

備註

LockResource傳回的指標有效，直到包含資源的模組卸載為止。 不需要解除鎖定資源，因為系統會在建立資源的程式終止時自動將其刪除。

請勿嘗試使用 FindResourceA 函 式或 FindResourceExA 函 式傳回的控制碼來鎖定資源。 這類控制碼會指向亂數據。

注意

LockResource 實際上不會鎖定記憶體;它只是用來取得包含資源資料的記憶體指標。 函式的名稱來自 Windows XP 之前的版本，當它用來鎖定 LoadResource所配置的全域記憶體區塊時。

範例

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

需求

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

另請參閱

概念

參考