Process32First-Funktion (tlhelp32.h)

Artikel
03/02/2024

Ruft Informationen zum ersten Prozess ab, der in einem System Momentaufnahme gefunden wurde.

Syntax

BOOL Process32First(
  [in]      HANDLE           hSnapshot,
  [in, out] LPPROCESSENTRY32 lppe
);

Parameter

[in] hSnapshot

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

[in, out] lppe

Ein Zeiger auf eine PROCESSENTRY32-Struktur . Sie enthält Prozessinformationen wie den Namen der ausführbaren Datei, den Prozessbezeichner und den Prozessbezeichner des übergeordneten Prozesses.

Rückgabewert

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

Hinweise

Die aufrufende Anwendung muss den dwSize-Member von PROCESSENTRY32 auf die Größe der Struktur in Bytes festlegen.

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

Beispiele

Ein Beispiel finden Sie unter Erstellen einer Momentaufnahme und Anzeigen von Prozessen.

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