Fungsi GetExitCodeProcess (processthreadsapi.h)

Artikel
03/01/2024

Mengambil status penghentian proses yang ditentukan.

Sintaks

BOOL GetExitCodeProcess(
  [in]  HANDLE  hProcess,
  [out] LPDWORD lpExitCode
);

Parameter

[in] hProcess

Handel untuk proses.

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

Windows Server 2003 dan Windows XP: Handel harus memiliki hak akses PROCESS_QUERY_INFORMATION .

[out] lpExitCode

Penunjuk ke variabel untuk menerima status penghentian proses. Untuk informasi selengkapnya, lihat Keterangan.

Mengembalikan 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 ini segera kembali. Jika proses belum dihentikan dan fungsi berhasil, status yang dikembalikan STILL_ACTIVE (makro untuk STATUS_PENDING (minwinbase.h)). Jika proses telah dihentikan dan fungsi berhasil, status yang dikembalikan adalah salah satu nilai berikut:

Nilai keluar yang ditentukan dalam fungsi ExitProcess atau TerminateProcess .
Nilai yang dikembalikan dari fungsi utama atau WinMain dari proses.
Nilai pengecualian untuk pengecualian yang tidak tertangani yang menyebabkan proses dihentikan.

Penting

Fungsi GetExitCodeProcess mengembalikan kode kesalahan yang valid yang ditentukan oleh aplikasi hanya setelah utas dihentikan. Oleh karena itu, aplikasi tidak boleh menggunakan STILL_ACTIVE (259) sebagai kode kesalahan (STILL_ACTIVE adalah makro untuk STATUS_PENDING (minwinbase.h)). Jika utas mengembalikan STILL_ACTIVE (259) sebagai kode kesalahan, maka aplikasi yang menguji nilai tersebut dapat menafsirkannya berarti bahwa utas masih berjalan, dan terus menguji penyelesaian utas setelah utas dihentikan, yang dapat menempatkan aplikasi ke dalam perulangan tak terbatas.

Persyaratan

Persyaratan	Nilai
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