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

如果進程正在作業中執行，則為值指標，否則為 FALSE。

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

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

除非作業物件具有作業物件的名稱，否則應用程式無法取得其執行所在作業物件的句柄。不過，應用程式可以使用 NULL 呼叫 QueryInformationJobObject 函式，以取得作業對象的相關信息。

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