Process32First 函数 (tlhelp32.h)

检索有关系统快照中遇到的第一个进程的信息。

语法

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

[in] hSnapshot

快照的句柄，该句柄是从上次调用 CreateToolhelp32Snapshot 函数返回的。

[in, out] lppe

指向 PROCESSENTRY32 结构的指针。它包含进程信息，例如可执行文件的名称、进程标识符和父进程的进程标识符。

如果进程列表的第一个条目已复制到缓冲区，则返回 TRUE ，否则返回 FALSE 。如果不存在任何进程或快照不包含进程信息，则 GetLastError 函数将返回ERROR_NO_MORE_FILES错误值。

调用应用程序必须将 PROCESSENTRY32 的 dwSize 成员设置为结构的大小（以字节为单位）。

若要检索同一快照中记录的其他进程的相关信息，请使用 Process32Next 函数。