TerminateJobObject 函式 (jobapi2.h)

終止目前與作業相關聯的所有進程。如果作業是巢狀的，此函式會終止目前與作業相關聯的所有進程及其階層中的所有子作業。

語法

BOOL TerminateJobObject(
  [in] HANDLE hJob,
  [in] UINT   uExitCode
);

[in] hJob

作業的句柄，其進程將會終止。 CreateJobObject 或 OpenJobObject 函式會傳回這個句柄。此句柄必須具有JOB_OBJECT_TERMINATE訪問許可權。如需詳細資訊，請參閱作業物件安全性和訪問許可權。

作業物件中每個進程的句柄都必須具有PROCESS_TERMINATE訪問許可權。如需詳細資訊，請參閱處理安全性和訪問許可權。

[in] uExitCode

作業物件中所有進程和線程要使用的結束代碼。使用 GetExitCodeProcess 函式來擷取每個進程的結束值。使用 GetExitCodeThread 函式來擷取每個線程的結束值。

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

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

與作業相關聯的任何進程都無法延後或處理終止。就像針對與作業相關聯的每個進程呼叫 TerminateProcess 一樣。

終止巢狀作業會額外終止所有子工作物件。終止作業所使用的資源會向階層中的父作業鏈結收費。

若要編譯使用此函式的應用程式，請將_WIN32_WINNT定義為0x0500或更新版本。如需詳細資訊，請參閱使用 Windows 標頭。