LockResource 関数 (libloaderapi.h)

  • [アーティクル]

メモリ内の指定されたリソースへのポインターを取得します。

構文

LPVOID LockResource(
  [in] HGLOBAL hResData
);

パラメーター

[in] hResData

種類: HGLOBAL

アクセスするリソースへのハンドル。 LoadResource 関数は、このハンドルを返します。 このパラメーターは、下位互換性のためにのみ HGLOBAL 変数として一覧表示されることに注意してください。 LoadResource 関数からの正常な戻り値以外のパラメーターとして値を渡さないでください。

戻り値

種類: LPVOID

読み込まれたリソースが使用可能な場合、戻り値はリソースの最初のバイトへのポインターです。それ以外の場合は NULL です。

解説

LockResource によって返されるポインターは、リソースを含むモジュールがアンロードされるまで有効です。 リソースを作成したプロセスが終了すると、自動的にリソースが削除されるため、リソースのロックを解除する必要はありません。

FindResourceA 関数または FindResourceExA 関数によって返されるハンドルを使用してリソースをロックしないでください。 このようなハンドルは、ランダム なデータを指します。

注意

LockResource は実際にはメモリをロックしません。これは、リソース データを含むメモリへのポインターを取得するためにのみ使用されます。 関数の名前は、 LoadResource によって割り当てられたグローバル メモリ ブロックをロックするために使用されていた Windows XP より前のバージョンから取得されます。

例

例については、「 リソースの更新」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー libloaderapi.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

概念

リファレンス