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:
- Der in der ExitThread - oder TerminateThread-Funktion angegebene Exitwert .
- Der Rückgabewert der Threadfunktion.
- Der Exitwert des Prozesses des Threads.
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 |