Thread32First 函式 (tlhelp32.h)

發行項
03/05/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
程式庫	Kernel32.lib
DLL	Kernel32.dll