Fungsi TerminateProcess (processthreadsapi.h)
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 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk