Fungsi GetExitCodeThread (processthreadsapi.h)

Artikel
08/25/2023

Mengambil status penghentian utas yang ditentukan.

Sintaks

BOOL GetExitCodeThread(
  [in]  HANDLE  hThread,
  [out] LPDWORD lpExitCode
);

Parameter

[in] hThread

Handel ke utas.

Handel harus memiliki hak akses THREAD_QUERY_INFORMATION atau THREAD_QUERY_LIMITED_INFORMATION . Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.

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

[out] lpExitCode

Penunjuk ke variabel untuk menerima status penghentian utas. 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 utas yang ditentukan belum dihentikan dan fungsi berhasil, status yang dikembalikan STILL_ACTIVE. Jika utas telah dihentikan dan fungsi berhasil, status yang dikembalikan adalah salah satu nilai berikut:

Nilai keluar yang ditentukan dalam fungsi ExitThread atau TerminateThread .
Nilai yang dikembalikan dari fungsi utas.
Nilai keluar dari proses utas.

Penting Fungsi GetExitCodeThread 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. Jika utas mengembalikan STILL_ACTIVE (259) sebagai kode kesalahan, aplikasi yang menguji nilai ini dapat menafsirkannya berarti bahwa utas masih berjalan dan terus menguji penyelesaian utas setelah utas dihentikan, yang dapat menempatkan aplikasi ke dalam perulangan tak terbatas. Untuk menghindari masalah ini, penelepon harus memanggil fungsi GetExitCodeThread hanya setelah utas dikonfirmasi telah keluar. Gunakan fungsi WaitForSingleObject dengan durasi tunggu nol untuk menentukan apakah utas telah keluar.

Windows Phone 8.1: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8.1 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

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; WindowsPhoneCore.lib di Windows Phone 8.1
DLL	Kernel32.dll; KernelBase.dll pada Windows Phone 8.1