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错误值。

注解

调用应用程序必须将 PROCESSENTRY32dwSize 成员设置为 结构的大小(以字节为单位)。

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

示例

有关示例,请参阅 拍摄快照和查看进程

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 tlhelp32.h
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

CreateToolhelp32Snapshot

PROCESSENTRY32

流程步行

Process32Next

工具帮助函数