GetExitCodeThread-Funktion (processthreadsapi.h)

Artikel
03/01/2024

Ruft die beendigungs-status des angegebenen Threads ab.

Syntax

BOOL GetExitCodeThread(
  [in]  HANDLE  hThread,
  [out] LPDWORD lpExitCode
);

Parameter

[in] hThread

Ein Handle auf den Thread.

Das Handle muss über das zugriffsrecht THREAD_QUERY_INFORMATION oder THREAD_QUERY_LIMITED_INFORMATION verfügen. Weitere Informationen finden Sie unter Threadsicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das zugriffsrecht THREAD_QUERY_INFORMATION verfügen.

[out] lpExitCode

Ein Zeiger auf eine Variable, um die Threadabschluss-status zu empfangen. 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 angegebene Thread nicht beendet wurde und die Funktion erfolgreich ist, wird die zurückgegebene status STILL_ACTIVE. Wenn der Thread beendet wurde und die Funktion erfolgreich ist, ist der zurückgegebene status einer der folgenden Werte:

Der in der ExitThread - oder TerminateThread-Funktion angegebene Exitwert .
Der Rückgabewert der Threadfunktion.
Der Exitwert des Prozesses des Threads.

Wichtig Die GetExitCodeThread-Funktion gibt einen gültigen Fehlercode zurück, der von der Anwendung erst nach dem Beenden des Threads definiert wird. Daher sollte eine Anwendung STILL_ACTIVE (259) nicht als Fehlercode verwenden. Wenn ein Thread STILL_ACTIVE (259) als Fehlercode zurückgibt, können Anwendungen, die auf diesen Wert testen, dies so interpretieren, dass der Thread weiterhin ausgeführt wird und nach Beendigung des Threads weiterhin auf die Vervollständigung des Threads getestet wird, wodurch die Anwendung in eine Endlosschleife versetzt werden kann. Um dieses Problem zu vermeiden, sollten Aufrufer die GetExitCodeThread-Funktion erst aufrufen, nachdem bestätigt wurde, dass der Thread beendet wurde. Verwenden Sie die WaitForSingleObject-Funktion mit einer Wartezeit von 0 (null), um zu bestimmen, ob ein Thread beendet wurde.

Windows Phone 8.1: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8.1 unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

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; WindowsPhoneCore.lib auf Windows Phone 8.1
DLL	Kernel32.dll; KernelBase.dll am Windows Phone 8.1