K32EnumProcesses

システム内の各プロセス オブジェクトのプロセス識別子を取得する。

K32EnumProcesses lpidProcess, cb, lpcbNeeded

lpidProcess : [var] プロセス識別子のリストを受け取る配列へのポインタ。
cb : [int] pProcessIds 配列のサイズ（バイト単位）。
lpcbNeeded : [var] pProcessIds 配列に返されたバイト数。

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

解説

システム内の各プロセス オブジェクトのプロセス識別子を取得する。

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

[備考]
EnumProcesses
を呼ぶ時点で何個プロセスが存在するかを予測しにくいため、大きな配列を使うのが望ましい。列挙されたプロセスの数を求めるには、lpcbNeeded
値を sizeof(DWORD)
で割る。バッファが小さすぎてすべてのプロセス識別子を格納できない場合でもその旨を示すものは無い。したがって、lpcbNeeded が cb
と等しい場合は、より大きな配列で再度呼ぶことを検討する。取得した識別子からプロセス ハンドルを取得するには OpenProcess
関数を呼ぶ。Windows 7 および Windows Server 2008 R2 以降、Psapi.h は PSAPI
関数のバージョン番号を定めている。PSAPI
バージョン番号は、関数を呼ぶときに使う名前とプログラムが読み込むライブラリに影響する。PSAPI_VERSION が 2
以上の場合、この関数は Psapi.h で K32EnumProcesses として定義され、Kernel32.lib と
Kernel32.dll にエクスポートされる。PSAPI_VERSION が 1 の場合、Psapi.h で EnumProcesses
として定義され、Psapi.lib と Psapi.dll に K32EnumProcesses
を呼ぶラッパーとしてエクスポートされる。旧バージョンの Windows と Windows 7 以降の両方で動かすプログラムは常に
EnumProcesses として呼ぶべきである。シンボルを正しく解決するためには、TARGETLIBS マクロに Psapi.lib
を追加し、-DPSAPI_VERSION=1 付きでコンパイルする。実行時動的リンクを使うには Psapi.dll を読み込む。

情報