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 |