EnumProcessModules 関数 (psapi.h)

[アーティクル]
03/01/2024

指定したプロセス内の各モジュールのハンドルを取得します。

64 ビットアプリケーションが 32 ビットモジュール、64 ビットモジュール、または両方の種類のモジュールを列挙するかどうかを制御するには、 EnumProcessModulesEx 関数を使用します。

構文

BOOL EnumProcessModules(
  [in]  HANDLE  hProcess,
  [out] HMODULE *lphModule,
  [in]  DWORD   cb,
  [out] LPDWORD lpcbNeeded
);

パラメーター

[in] hProcess

プロセスへのハンドル。

[out] lphModule

モジュールハンドルの一覧を受け取る配列。

[in] cb

lphModule 配列のサイズ (バイト単位)。

[out] lpcbNeeded

すべてのモジュールハンドルを lphModule 配列に格納するために必要なバイト数。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

EnumProcessModules 関数は、主に、別のプロセスからモジュール情報を抽出する必要があるデバッガーや同様のアプリケーションで使用するように設計されています。ターゲットプロセス内のモジュールリストが破損しているか、まだ初期化されていない場合、または DLL の読み込みまたはアンロードの結果として関数呼び出し中にモジュールリストが変更された場合、 EnumProcessModules が失敗したり、正しくない情報が返されたりする可能性があります。

EnumProcessModules を呼び出す時点でプロセス内に存在するモジュールの数を予測することは困難であるため、HMODULE 値の大きな配列を指定することをお勧めします。 lphModule 配列が小さすぎてプロセスのすべてのモジュールハンドルを保持できるかどうかを判断するには、lpcbNeeded で返される値と cb で指定された値を比較します。 lpcbNeeded が cb より大きい場合は、配列のサイズを大きくし、EnumProcessModules をもう一度呼び出します。

EnumProcessModules の呼び出しによって列挙されたモジュールの数を確認するには、結果の値を lpcbNeeded パラメーターででsizeof(HMODULE)除算します。

EnumProcessModules 関数は、LOAD_LIBRARY_AS_DATAFILEまたは同様のフラグで読み込まれたモジュールのハンドルを取得しません。詳細については、「 LoadLibraryEx」を参照してください。

この関数によって返されるハンドルに対して CloseHandle を呼び出さないでください。情報はスナップショットから取得されるため、解放するリソースはありません。

この関数が WOW64 で実行されている 32 ビットアプリケーションから呼び出された場合、32 ビットプロセスのモジュールのみを列挙できます。プロセスが 64 ビットプロセスの場合、この関数は失敗し、最後のエラーコードは ERROR_PARTIAL_COPY (299) です。

指定したプロセスと、これらのプロセスで使用されるヒープ、モジュール、スレッドのスナップショットを取得するには、CreateToolhelp32Snapshot 関数を使用します。

Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI 関数のバージョン番号を確立します。 PSAPI バージョン番号は、プログラムが読み込む必要がある関数とライブラリの呼び出しに使用される名前に影響します。

PSAPI_VERSIONが 2 以上の場合、この関数は Psapi.h の K32EnumProcessModules として定義され、Kernel32.lib および Kernel32.dll でエクスポートされます。 PSAPI_VERSION が 1 の場合、この関数は Psapi.h の EnumProcessModules として定義され、Psapi.lib でエクスポートされ、K32EnumProcessModules を呼び出すラッパーとして Psapi.dll されます。

以前のバージョンの Windows および Windows 7 以降のバージョンで実行する必要があるプログラムは、常に この関数を EnumProcessModules として呼び出す必要があります。シンボルを正しく解決するには、 PSapi.lib を TARGETLIBS マクロに追加し、 -DPSAPI_VERSION=1 でプログラムをコンパイルします。実行時の動的リンクを使用するには、Psapi.dll を読み込みます。

例

例については、「すべてのプロセスの列挙」または「プロセスのすべてのモジュールの列挙」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	psapi.h
Library	Windows 7 および Windows Server 2008 R2 の Kernel32.lib。Windows 7 および Windows Server 2008 R2 の Psapi.lib (PSAPI_VERSION=1 の場合)。Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の Psapi.lib
[DLL]	Windows 7 および Windows Server 2008 R2 で Kernel32.dll。Windows 7 および Windows Server 2008 R2 で Psapi.dll (PSAPI_VERSION=1 の場合)。Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP の Psapi.dll