共用方式為


TerminateJobObject 函式 (jobapi2.h)

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

語法

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

參數

[in] hJob

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

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

[in] uExitCode

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

傳回值

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

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

備註

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

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

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

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 jobapi2.h (包括 Windows.h、Jobapi2.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

CreateJobObject

作業物件

OpenJobObject

處理序和執行緒函式

TerminateProcess