GetExitCodeProcess-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Ruft die beendigungs-status des angegebenen Prozesses ab.

Syntax

BOOL GetExitCodeProcess(
  [in]  HANDLE  hProcess,
  [out] LPDWORD lpExitCode
);

Parameter

[in] hProcess

Ein Handle für den Prozess.

Das Handle muss über das PROCESS_QUERY_INFORMATION - oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das Zugriffsrecht PROCESS_QUERY_INFORMATION verfügen.

[out] lpExitCode

Ein Zeiger auf eine Variable, um den Prozessabschluss status zu erhalten. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion gibt sofort zurück. Wenn der Prozess nicht beendet wurde und die Funktion erfolgreich ist, wird die zurückgegebene status STILL_ACTIVE (ein Makro für STATUS_PENDING (minwinbase.h)) zurückgegeben. Wenn der Prozess beendet wurde und die Funktion erfolgreich ist, ist der zurückgegebene status einer der folgenden Werte:

Der in der ExitProcess- oder TerminateProcess-Funktion angegebene Exitwert .
Der Rückgabewert der Standard- oder WinMain-Funktion des Prozesses.
Der Ausnahmewert für eine nicht behandelte Ausnahme, die dazu geführt hat, dass der Prozess beendet wurde.

Wichtig

Die GetExitCodeProcess-Funktion gibt erst nach dem Beenden des Threads einen gültigen Fehlercode zurück, der von der Anwendung definiert wird. Daher sollte eine Anwendung STILL_ACTIVE (259) nicht als Fehlercode verwenden (STILL_ACTIVE ist ein Makro für STATUS_PENDING (minwinbase.h)). Wenn ein Thread STILL_ACTIVE (259) als Fehlercode zurückgibt, können Anwendungen, die auf diesen Wert testen, dies so interpretieren, dass der Thread noch ausgeführt wird, und weiterhin testen, ob der Thread abgeschlossen ist, nachdem der Thread beendet wurde, wodurch die Anwendung in eine Endlosschleife versetzt werden könnte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll