ImageLoad 関数 (imagehlp.h)

読み込まれた DLL の一覧を保持します。

構文

PLOADED_IMAGE IMAGEAPI ImageLoad(
  [in] PCSTR DllName,
  [in] PCSTR DllPath
);

[in] DllName

イメージの名前。

[in] DllPath

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

関数が成功した場合、戻り値は LOADED_IMAGE 構造体へのポインターです。

関数が失敗した場合は、返される値は NULL です。拡張エラー情報を取得するには、 GetLastError を呼び出します。

ImageLoad 関数は、読み込まれた DLL の一覧を維持するために使用されます。イメージが既に読み込まれている場合は、前の LOADED_IMAGE が返されます。それ以外の場合は、新しいイメージが一覧に追加されます。

LOADED_IMAGE構造体は、ImageUnload 関数によって割り当てを解除する必要があります。

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