Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Mengakhiri proses yang ditentukan dan semua utasnya.
Syntax
BOOL TerminateProcess(
[in] HANDLE hProcess,
[in] UINT uExitCode
);
Parameter-parameternya
[in] hProcess
Handel ke proses yang akan dihentikan.
Handel harus memiliki akses PROCESS_TERMINATE yang tepat. 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.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.
Komentar
Fungsi TerminateProcess digunakan untuk secara tidak bersyarat 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 telah 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 dengan sendirinya, TerminateProcess menghentikan eksekusi utas panggilan dan tidak kembali. Jika tidak, TerminateProcess bersifat asinkron; 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, panggilan ke TerminateProcess dengan handel terbuka ke proses gagal dengan kode kesalahan ERROR_ACCESS_DENIED (5).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Platform Target | Windows |
| Header | processthreadsapi.h (termasuk Windows.h pada Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |