Fungsi IsProcessInJob (jobapi.h)

Menentukan apakah proses berjalan dalam pekerjaan yang ditentukan.

Sintaks

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

Parameter

[in] ProcessHandle

Handel untuk proses yang akan diuji. Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION atau PROCESS_QUERY_LIMITED_INFORMATION. Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.

Windows Server 2003 dan Windows XP: Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION.

[in, optional] JobHandle

Handel untuk pekerjaan. Jika parameter ini NULL, fungsi akan menguji apakah proses berjalan di bawah pekerjaan apa pun.

Jika parameter ini bukan NULL, handel harus memiliki hak akses JOB_OBJECT_QUERY. Untuk informasi selengkapnya, lihat Keamanan Objek Pekerjaan dan Hak Akses.

[out] Result

Pointer ke nilai yang menerima TRUE jika proses berjalan dalam pekerjaan, dan FALSE sebaliknya.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Aplikasi tidak dapat memperoleh handel ke objek pekerjaan tempat aplikasi berjalan kecuali memiliki nama objek pekerjaan. Namun, aplikasi dapat memanggil fungsi QueryInformationJobObject dengan NULL untuk mendapatkan informasi tentang objek pekerjaan.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0501 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header jobapi.h
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

AssignProcessToJobObject

Objek Pekerjaan

Fungsi Proses dan Utas

QueryInformationJobObject