Process32First-Funktion (tlhelp32.h)
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 |