MapAndLoad 関数 (imagehlp.h)

イメージをマップし、マップされたファイルからデータを事前に読み込みます。

構文

BOOL IMAGEAPI MapAndLoad(
  [in]  PCSTR         ImageName,
  [in]  PCSTR         DllPath,
  [out] PLOADED_IMAGE LoadedImage,
  [in]  BOOL          DotDll,
  [in]  BOOL          ReadOnly
);

パラメーター

[in] ImageName

読み込まれるイメージ (実行可能ファイルまたは DLL) のファイル名。

[in] DllPath

指定された名前が見つからない場合にイメージの検索に使用されるパス。 このパラメーターが NULL の場合、 SearchPath 関数を使用して設定された検索パスルールが適用されます。

[out] LoadedImage

読み込まれた 後にイメージ に関する情報を受け取るLOADED_IMAGE構造体へのポインター。

[in] DotDll

イメージ名にファイル名拡張子が含まれていない場合に使用される既定の拡張子。 値が TRUE の場合は、.DLL 拡張機能が使用されます。 値が FALSE の場合は、.EXE 拡張機能が使用されます。

[in] ReadOnly

アクセス モード。 この値が TRUE の場合、ファイルは読み取りアクセス専用にマップされます。 値が FALSE の場合、ファイルは読み取りおよび書き込みアクセス用にマップされます。

戻り値

関数が成功した場合、戻り値は TRUE になります。

関数が失敗した場合、戻り値は FALSE になります。 拡張エラー情報を取得するには、 GetLastError を呼び出します。

解説

MapAndLoad 関数は、イメージをマップし、マップされたファイルからデータを事前に読み込みます。 対応する関数 UnMapAndLoad を使用して、 MapAndLoad 関数によって割り当てられているすべてのリソースの割り当てを解除する必要があります。

この関数など、すべての ImageHlp 関数はシングル スレッドです。 そのため、複数のスレッドからこの関数を呼び出すと、予期しない動作やメモリ破損が発生する可能性があります。 これを回避するには、複数のスレッドからのすべての同時呼び出しをこの関数に同期する必要があります。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	imagehlp.h
Library	Imagehlp.lib
[DLL]	Imagehlp.dll

関連項目

ImageHlp 関数

LOADED_IMAGE

UnMapAndLoad