IsProcessInJob 関数 (jobapi.h)

指定したジョブでプロセスが実行されているかどうかを判断します。

構文

BOOL IsProcessInJob(
  [in]           HANDLE ProcessHandle,
  [in, optional] HANDLE JobHandle,
  [out]          PBOOL  Result
);

[in] ProcessHandle

テストするプロセスへのハンドル。ハンドルには、PROCESS_QUERY_INFORMATIONまたはPROCESS_QUERY_LIMITED_INFORMATIONアクセス権が必要です。詳細については、「プロセスのセキュリティとアクセス権」を参照してください。

Windows Server 2003 および Windows XP: ハンドルには、PROCESS_QUERY_INFORMATIONアクセス権が必要です。

[in, optional] JobHandle

ジョブへのハンドル。このパラメーターが NULL の場合、関数はプロセスが任意のジョブで実行されているかどうかをテストします。

このパラメーターが NULL でない場合、ハンドルにはJOB_OBJECT_QUERYアクセス権が必要です。詳細については、「ジョブオブジェクトのセキュリティとアクセス権」を参照してください。

[out] Result

プロセスがジョブで実行されている場合は TRUE、それ以外の場合は FALSE を受け取る値へのポインター。

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

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

アプリケーションは、ジョブオブジェクトの名前がない限り、実行中のジョブオブジェクトへのハンドルを取得できません。ただし、アプリケーションは NULL を指定して QueryInformationJobObject 関数を呼び出して、ジョブオブジェクトに関する情報を取得できます。

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