Fungsi ResumeThread (processthreadsapi.h)

Artikel
03/08/2023

Mengurangi jumlah utas yang ditangguhkan. Ketika jumlah penangguhan diurutkan menjadi nol, eksekusi utas dilanjutkan.

Sintaks

DWORD ResumeThread(
  [in] HANDLE hThread
);

Parameter

[in] hThread

Handel ke utas yang akan dimulai ulang.

Handel ini harus memiliki hak akses THREAD_SUSPEND_RESUME. Untuk informasi selengkapnya, lihat Keamanan Utas dan Hak Akses.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah jumlah penangguhan utas sebelumnya.

Jika fungsi gagal, nilai yang dikembalikan adalah (DWORD) -1. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ResumeThread memeriksa jumlah penangguhan utas subjek. Jika jumlah penangguhan adalah nol, utas saat ini tidak ditangguhkan. Jika tidak, jumlah penangguhan utas subjek akan dikurangi. Jika nilai yang dihasilkan adalah nol, maka eksekusi utas subjek dilanjutkan.

Jika nilai yang dikembalikan adalah nol, utas yang ditentukan tidak ditangguhkan. Jika nilai yang dikembalikan adalah 1, utas yang ditentukan ditangguhkan tetapi dimulai ulang. Jika nilai yang dikembalikan lebih besar dari 1, utas yang ditentukan masih ditangguhkan.

Perhatikan bahwa saat melaporkan peristiwa debug, semua utas dalam proses pelaporan dibekukan. Debugger diharapkan menggunakan fungsi SuspendThread dan ResumeThread untuk membatasi kumpulan utas yang dapat dijalankan dalam proses. Dengan menangguhkan semua utas dalam proses kecuali untuk yang melaporkan peristiwa debug, dimungkinkan untuk "satu langkah" satu utas. Utas lainnya tidak dirilis oleh operasi lanjutan jika ditangguhkan.

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