Fungsi ZwTerminateProcess (ntddk.h)

  • Artikel

Rutinitas ZwTerminateProcess mengakhiri proses dan semua utasnya.

Sintaks

NTSYSAPI NTSTATUS ZwTerminateProcess(
  [in, optional] HANDLE   ProcessHandle,
  [in]           NTSTATUS ExitStatus
);

Parameter

[in, optional] ProcessHandle

Handel ke objek proses yang mewakili proses yang akan dihentikan.

[in] ExitStatus

Nilai NTSTATUS yang digunakan sistem operasi sebagai status akhir untuk proses dan masing-masing utasnya.

Nilai kembali

ZwTerminateProcess mengembalikan STATUS_SUCCESS jika operasi berhasil. Nilai pengembalian tambahan meliputi:

Menampilkan kode Deskripsi
STATUS_OBJECT_TYPE_MISMATCH Handel yang ditentukan bukan handel proses.
STATUS_INVALID_HANDLE Handel yang ditentukan tidak valid.
STATUS_ACCESS_DENIED Driver tidak dapat mengakses objek proses yang ditentukan.
STATUS_PROCESS_IS_TERMINATING Proses yang ditentukan sudah berakhir.

Jika pemanggil menentukan proses saat ini dalam parameter ProcessHandle , ZwTerminateProcess tidak mengembalikan.

Keterangan

Untuk mendapatkan handel proses yang dapat ditentukan driver untuk parameter ProcessHandle , driver dapat memanggil ZwOpenProcess. Handel harus berupa handel kernel, handel yang hanya dapat diakses dalam mode kernel. Handel adalah handel kernel jika dibuat dengan bendera OBJ_KERNEL_HANDLE. Untuk informasi selengkapnya lihat InitializeObjectAttributes.

Driver tidak boleh menentukan proses saat ini jika sumber daya belum dikosongkan dari tumpukan kernel, karena sistem operasi tidak akan melepas tumpukan kernel untuk utas panggilan.

Jika panggilan ke fungsi ini terjadi dalam mode pengguna, Anda harus menggunakan nama "NtTerminateProcess" alih-alih "ZwTerminateProcess".

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ntddk.h (termasuk Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Lihat juga

Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli

ZwOpenProcess