Thread32First 函数 (tlhelp32.h)
检索有关系统快照中遇到的任何进程的第一个线程的信息。
语法
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 |