Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft Informationen zum ersten Prozess ab, der in einer Systemmomentaufnahme aufgetreten ist.
Syntax
BOOL Process32FirstW(
[in] HANDLE hSnapshot,
[in, out] LPPROCESSENTRY32W lppe
);
Parameter
[in] hSnapshot
Ein Handle für die Momentaufnahme, die von einem vorherigen Aufruf der CreateToolhelp32Snapshot--Funktion zurückgegeben wurde.
[in, out] lppe
Ein Zeiger auf eine PROCESSENTRY32W 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 FALSE andernfalls. 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.
Bemerkungen
Die aufrufende Anwendung muss die dwSize Member von PROCESSENTRY32W auf die Größe der Struktur in Bytes festlegen.
Um Informationen zu anderen Prozessen abzurufen, die in derselben Momentaufnahme aufgezeichnet wurden, verwenden Sie die Process32Next--Funktion.
Beispiele
Ein Beispiel finden Sie unter Erstellen einer Momentaufnahme und Anzeigen von Prozessen.
Anmerkung
Der tlhelp32.h-Header definiert Process32First als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | tlhelp32.h |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |