Freigeben über


GetExitCodeThread-Funktion (processthreadsapi.h)

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:

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

Weitere Informationen

ExitThread

GetExitCodeProcess

OpenThread

Prozess- und Threadfunktionen

TerminateThread

Beenden eines Threads