LockResource 函式 (libloaderapi.h)

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

語法

LPVOID LockResource(
  [in] HGLOBAL hResData
);

[in] hResData

類型： HGLOBAL

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

類型： LPVOID

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

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

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

注意

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

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