Fungsi TerminateJobObject (jobapi2.h)

  • Artikel

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

Lihat juga

CreateJobObject

Objek Pekerjaan

OpenJobObject

Fungsi Proses dan Utas

TerminateProcess