Process32First 関数 (tlhelp32.h)

  • [アーティクル]

システム スナップショットで最初に検出されたプロセスに関する情報を取得します。

構文

BOOL Process32First(
  [in]      HANDLE           hSnapshot,
  [in, out] LPPROCESSENTRY32 lppe
);

パラメーター

[in] hSnapshot

CreateToolhelp32Snapshot 関数の以前の呼び出しから返されたスナップショットへのハンドル。

[in, out] lppe

PROCESSENTRY32構造体へのポインター。 これには、実行可能ファイルの名前、プロセス識別子、親プロセスのプロセス識別子などのプロセス情報が含まれます。

戻り値

プロセス リストの最初のエントリがバッファーにコピーされた場合は TRUE 、それ以外の場合は FALSE を 返します。 ERROR_NO_MORE_FILESエラー値は、プロセスが存在しないか、スナップショットにプロセス情報が含まれていない場合、GetLastError 関数によって返されます。

注釈

呼び出し元のアプリケーションでは、PROCESSENTRY32 の dwSize メンバーを構造体のサイズ (バイト単位) に設定する必要があります。

同じスナップショットに記録されている他のプロセスに関する情報を取得するには、Process32Next 関数を使用します。

例

例については、「 スナップショットの作成」と「プロセスの表示」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー tlhelp32.h
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

CreateToolhelp32Snapshot

PROCESSENTRY32

プロセス ウォーキング

Process32Next

ツール ヘルプ関数