TerminateJobObject 関数 (jobapi2.h)

ジョブに現在関連付けられているすべてのプロセスを終了します。ジョブが入れ子になっている場合、この関数は、現在ジョブに関連付けられているすべてのプロセスと階層内のすべての子ジョブを終了します。

構文

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

[in] hJob

プロセスが終了するジョブへのハンドル。 CreateJobObject 関数または OpenJobObject 関数は、このハンドルを返します。このハンドルには、JOB_OBJECT_TERMINATEアクセス権が必要です。詳細については、「ジョブオブジェクトのセキュリティとアクセス権」を参照してください。

ジョブオブジェクト内の各プロセスのハンドルには、PROCESS_TERMINATEアクセス権が必要です。詳細については、「プロセスのセキュリティとアクセス権」を参照してください。

[in] uExitCode

ジョブオブジェクト内のすべてのプロセスとスレッドで使用される終了コード。 GetExitCodeProcess 関数を使用して、各プロセスの終了値を取得します。 GetExitCodeThread 関数を使用して、各スレッドの終了値を取得します。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

ジョブに関連付けられているどのプロセスも、終了を延期または処理することはできません。ジョブに関連付けられている各プロセスに対して TerminateProcess が呼び出されたかのように表示されます。

入れ子になったジョブを終了すると、さらにすべての子ジョブオブジェクトが終了します。終了したジョブによって使用されるリソースは、階層内の親ジョブチェーンに課金されます。

この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNTを 0x0500 以降として定義します。詳細については、「 Windows ヘッダーの使用」を参照してください。

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	jobapi2.h (Windows.h、Jobapi2.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll