GetExitCodeThread 函式 (processthreadsapi.h)

發行項
03/13/2024

擷取指定線程的終止狀態。

語法

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

參數

[in] hThread

線程的句柄。

句柄必須具有 THREAD_QUERY_INFORMATION 或 THREAD_QUERY_LIMITED_INFORMATION 訪問許可權。如需詳細資訊，請參閱線程安全性和訪問許可權。

Windows Server 2003 和 Windows XP： 句柄必須具有 THREAD_QUERY_INFORMATION 訪問許可權。

[out] lpExitCode

要接收線程終止狀態之變數的指標。如需詳細資訊，請參閱＜備註＞。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

此函式會立即傳回。如果指定的線程尚未終止，且函式成功，則傳回的狀態 會STILL_ACTIVE。如果線程已終止且函式成功，傳回的狀態就是下列其中一個值：

ExitThread 或 TerminateThread 函式中指定的結束值。
線程函式的傳回值。
線程進程的結束值。

重要GetExitCodeThread 函式只會在線程終止之後，傳回應用程式所定義的有效錯誤碼。因此，應用程式不應該使用 STILL_ACTIVE (259) 作為錯誤碼。如果線程傳回 STILL_ACTIVE (259) 為錯誤碼，則測試此值的應用程式可能會解譯為表示線程仍在執行，並在線程終止之後繼續測試線程完成，這可能會讓應用程式進入無限迴圈。若要避免這個問題，呼叫端應該只有在確認線程已結束之後，才呼叫 GetExitCodeThread 函式。使用 WaitForSingleObject 函式的等候持續時間為零，以判斷線程是否已結束。

Windows Phone 8.1：Windows Phone 8.1 和更新版本上的 Windows Phone Store 應用程式支援此函式。

Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	processthreadsapi.h (Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
程式庫	Kernel32.lib;Windows Phone 8.1 上的 WindowsPhoneCore.lib
Dll	Kernel32.dll;Windows Phone 8.1 上的 KernelBase.dll