Fungsi TerminateProcess (processthreadsapi.h)

Artikel
02/07/2024

Mengakhiri proses yang ditentukan dan semua utasnya.

Sintaks

BOOL TerminateProcess(
  [in] HANDLE hProcess,
  [in] UINT   uExitCode
);

Parameter

[in] hProcess

Handel ke proses yang akan dihentikan.

Handel harus memiliki hak akses PROCESS_TERMINATE . Untuk informasi selengkapnya, lihat Keamanan Proses dan Hak Akses.

[in] uExitCode

Kode keluar yang akan digunakan oleh proses dan utas dihentikan sebagai akibat dari panggilan ini. Gunakan fungsi GetExitCodeProcess untuk mengambil nilai keluar proses. Gunakan fungsi GetExitCodeThread untuk mengambil nilai keluar utas.

Menampilkan nilai

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

Fungsi TerminateProcess digunakan untuk secara tanpa syarat menyebabkan proses keluar. Status data global yang dikelola oleh pustaka tautan dinamis (DLL) dapat disusupi jika TerminateProcess digunakan daripada ExitProcess.

Fungsi ini menghentikan eksekusi semua utas dalam proses dan meminta pembatalan semua I/O yang tertunda. Proses yang dihentikan tidak dapat keluar sampai semua I/O yang tertunda selesai atau dibatalkan. Ketika proses berakhir, objek kernelnya tidak dihancurkan sampai semua proses yang memiliki handel terbuka untuk proses telah melepaskan handel tersebut.

Ketika proses berakhir sendiri, TerminateProcess menghentikan eksekusi utas panggilan dan tidak kembali. Jika tidak, TerminateProcess tidak sinkron; ini memulai penghentian dan segera kembali. Jika Anda perlu memastikan proses telah dihentikan, panggil fungsi WaitForSingleObject dengan handel ke proses.

Proses tidak dapat mencegah dirinya dihentikan.

Setelah proses dihentikan, panggil Ke TerminateProcess dengan handel terbuka ke proses gagal dengan kode kesalahan ERROR_ACCESS_DENIED (5).

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	processthreadsapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll