K32EnumProcessModulesEx

指定したプロセスで、指定したフィルタ条件を満たす各モジュールのハンドルを取得する。

K32EnumProcessModulesEx hProcess, lphModule, cb, lpcbNeeded, dwFilterFlag

hProcess : [intptr] プロセスへのハンドル。
lphModule : [intptr] モジュール ハンドルのリストを受け取る配列。
cb : [int] lphModule 配列のサイズ（バイト単位）。
lpcbNeeded : [var] lphModule 配列にすべてのモジュール ハンドルを格納するのに必要なバイト数。
dwFilterFlag : [int] 

(プラグイン / モジュール : kernel32.dll)

解説

指定したプロセスで、指定したフィルタ条件を満たす各モジュールのハンドルを取得する。

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
EnumProcessModulesEx
関数は主にデバッガや、他プロセスからモジュール情報を抽出する類似アプリケーションでの使用を目的としている。ターゲット プロセスのモジュール
リストが壊れている、もしくはまだ初期化されていない、あるいは DLL の読み込み・アンロードの結果として関数呼び出し中にモジュール
リストが変わる場合、EnumProcessModulesEx は失敗したり誤った情報を返すことがある。この関数は主に 64 ビット
アプリケーション向けである。WOW64 下で実行される 32 ビット アプリケーションから呼ぶと dwFilterFlag
オプションは無視され、関数は EnumProcessModules と同じ結果を返す。EnumProcessModulesEx
を呼ぶ時点でプロセスにいくつモジュールが存在するか予測しにくいので、HMODULE
値の大きな配列を指定するのが望ましい。lphModule 配列がプロセスのすべてのモジュール
ハンドルを保持するのに小さすぎるかは、lpcbNeeded に返る値と cb で指定した値を比較して判断する。lpcbNeeded が
cb より大きければ配列のサイズを増やして EnumProcessModulesEx を再度呼ぶ。EnumProcessModulesEx
の呼び出しで列挙されたモジュールの数を求めるには、lpcbNeeded の結果値を sizeof(HMODULE)
で割る。EnumProcessModulesEx は LOAD_LIBRARY_AS_DATAFILE
フラグで読み込まれたモジュールのハンドルは取得しない。詳細は LoadLibraryEx を参照のこと。この関数が返すハンドルに対して
CloseHandle
を呼んではならない。情報はスナップショットから得たものであり、解放すべきリソースはない。指定したプロセスと、それらが使うヒープ、モジュール、スレッドのスナップショットを撮るには
CreateToolhelp32Snapshot 関数を使う。Windows 7 および Windows Server 2008 R2
以降、Psapi.h は PSAPI 関数のバージョン番号を定めている。PSAPI
バージョン番号は、関数を呼ぶときに使う名前とプログラムが読み込むライブラリに影響する。PSAPI_VERSION が 2
以上の場合、この関数は Psapi.h で K32EnumProcessModulesEx として定義され、Kernel32.lib と
Kernel32.dll にエクスポートされる。PSAPI_VERSION が 1 の場合、Psapi.h で
EnumProcessModulesEx として定義され、Psapi.lib と Psapi.dll に
K32EnumProcessModulesEx を呼ぶラッパーとしてエクスポートされる。旧バージョンの Windows と Windows
7 以降の両方で動かすプログラムは常に EnumProcessModulesEx
として呼ぶべきである。シンボルを正しく解決するためには、TARGETLIBS マクロに Psapi.lib
を追加し、-DPSAPI_VERSION=1 付きでコンパイルする。実行時動的リンクを使うには Psapi.dll を読み込む。

情報