K32EnumProcessModules

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

K32EnumProcessModules hProcess, lphModule, cb, lpcbNeeded

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

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

解説

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

[戻り値]
関数が成功した場合、戻り値は 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 と Psapi.dll に
K32EnumProcessModules を呼ぶラッパーとしてエクスポートされる。旧バージョンの Windows と Windows 7
以降の両方で動かすプログラムは常に EnumProcessModules
として呼ぶべきである。シンボルを正しく解決するためには、TARGETLIBS マクロに Psapi.lib
を追加し、-DPSAPI_VERSION=1 付きでコンパイルする。実行時動的リンクを使うには Psapi.dll を読み込む。

情報