Fungsi TerminateJobObject (jobapi2.h)
Mengakhiri semua proses yang saat ini terkait dengan pekerjaan. Jika pekerjaan berlapis, fungsi ini mengakhiri semua proses yang saat ini terkait dengan pekerjaan dan semua pekerjaan turunannya dalam hierarki.
Sintaks
BOOL TerminateJobObject(
[in] HANDLE hJob,
[in] UINT uExitCode
);
Parameter
[in] hJob
Handel untuk pekerjaan yang prosesnya akan dihentikan. Fungsi CreateJobObject atau OpenJobObject mengembalikan handel ini. Handel ini harus memiliki hak akses JOB_OBJECT_TERMINATE. Untuk informasi selengkapnya, lihat Keamanan Objek Pekerjaan dan Hak Akses.
Handel untuk setiap proses dalam objek pekerjaan harus memiliki hak akses PROCESS_TERMINATE. Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.
[in] uExitCode
Kode keluar yang akan digunakan oleh semua proses dan utas dalam objek pekerjaan. Gunakan fungsi GetExitCodeProcess untuk mengambil nilai keluar setiap proses. Gunakan fungsi GetExitCodeThread untuk mengambil nilai keluar setiap utas.
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
Tidak dimungkinkan bagi salah satu proses yang terkait dengan pekerjaan untuk menunda atau menangani penghentian. Seolah-olah TerminateProcess dipanggil untuk setiap proses yang terkait dengan pekerjaan.
Mengakhiri pekerjaan berlapis juga mengakhiri semua objek pekerjaan anak. Sumber daya yang digunakan oleh pekerjaan yang dihentikan dikenakan biaya rantai pekerjaan induk dalam hierarki.
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0500 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 | jobapi2.h (termasuk Windows.h, Jobapi2.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |