Thread32First-Funktion (tlhelp32.h)

Artikel
03/02/2024

Ruft Informationen über den ersten Thread eines Prozesses ab, der in einem System Momentaufnahme gefunden wird.

Syntax

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

Parameter

[in] hSnapshot

Ein Handle für die Momentaufnahme von einem vorherigen Aufruf der CreateToolhelp32Snapshot-Funktion zurückgegeben.

[in, out] lpte

Ein Zeiger auf eine THREADENTRY32-Struktur .

Rückgabewert

Gibt TRUE zurück, wenn der erste Eintrag der Threadliste in den Puffer kopiert wurde, oder andernfalls FALSE . Der ERROR_NO_MORE_FILES Fehlerwert wird von der GetLastError-Funktion zurückgegeben, wenn keine Threads vorhanden sind oder der Momentaufnahme keine Threadinformationen enthält.

Hinweise

Die aufrufende Anwendung muss den dwSize-Member von THREADENTRY32 auf die Größe der Struktur in Bytes festlegen. Thread32First ändert dwSize in die Anzahl der Bytes, die in die Struktur geschrieben wurden. Dies ist niemals größer als der Anfangswert von dwSize, kann aber kleiner sein. Wenn der Wert kleiner ist, verlassen Sie sich nicht auf die Werte von Membern, deren Offsets größer als dieser Wert sind.

Verwenden Sie die Thread32Next-Funktion, um Informationen zu anderen Threads abzurufen, die in derselben Momentaufnahme aufgezeichnet wurden.

Beispiele

Ein Beispiel finden Sie unter Durchlaufen der Threadliste.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tlhelp32.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll