Thread32First 函数 (tlhelp32.h)

项目
03/02/2024

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

语法

BOOL Thread32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPTHREADENTRY32 lpte
);

参数

[in] hSnapshot

从对 CreateToolhelp32Snapshot 函数的上一次调用返回的快照句柄。

[in, out] lpte

指向 THREADENTRY32 结构的指针。

返回值

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

注解

调用应用程序必须将 THREADENTRY32 的 dwSize 成员设置为结构的大小（以字节为单位）。 Thread32First 将 dwSize 更改为写入结构的字节数。这永远不会大于 dwSize 的初始值，但它可能更小。如果值较小，则不要依赖于其偏移量大于此值的任何成员的值。

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

示例

有关示例，请参阅遍历线程列表。

要求

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