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 |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |