GetExitCodeProcess 函式 (processthreadsapi.h)

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

語法

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

參數

[in] hProcess

進程的句柄。

句柄必須具有 PROCESS_QUERY_INFORMATIONPROCESS_QUERY_LIMITED_INFORMATION 訪問許可權。 如需詳細資訊,請參閱 處理安全性和訪問許可權

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

[out] lpExitCode

要接收進程終止狀態之變數的指標。 如需詳細資訊,請參閱<備註>。

傳回值

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

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

備註

此函式會立即傳回。 如果進程尚未終止,且函式成功,傳回的狀態會STILL_ACTIVE (STATUS_PENDING (minwinbase.h) ) 的宏。 如果行程已終止且函式成功,傳回的狀態就是下列其中一個值:

重要

GetExitCodeProcess 函式只會在線程終止之後,傳回應用程式定義的有效錯誤碼。 因此,應用程式不應該使用 STILL_ACTIVE (259) 作為錯誤 (碼,STILL_ACTIVE是STATUS_PENDING (minwinbase.h) ) 的宏。 如果線程傳回 STILL_ACTIVE (259) 為錯誤碼,則測試該值的應用程式可能會解譯該值,表示線程仍在執行中,並在線程終止之後繼續測試線程是否完成,這可能會讓應用程式進入無限迴圈。

規格需求

需求
最低支援的用戶端 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
DLL Kernel32.dll

另請參閱

ExitProcess

ExitThread

處理序和執行緒函式

程序

TerminateProcess

終止進程

WinMain