Fungsi CloseThreadpoolWait (threadpoolapiset.h)

Artikel
03/02/2024

Melepaskan objek tunggu yang ditentukan.

Sintaks

void CloseThreadpoolWait(
  [in, out] PTP_WAIT pwa
);

Parameter

[in, out] pwa

Penunjuk ke struktur TP_WAIT yang menentukan objek tunggu. Fungsi CreateThreadpoolWait mengembalikan penunjuk ini.

Mengembalikan nilai

Tidak ada

Keterangan

Objek tunggu segera dibebaskan jika tidak ada panggilan balik yang luar biasa; jika tidak, objek timer dibebaskan secara asinkron setelah panggilan balik yang luar biasa selesai.

Dalam beberapa kasus, fungsi panggilan balik mungkin berjalan setelah CloseThreadpoolWait dipanggil. Untuk mencegah perilaku ini:

Panggil fungsi SetThreadpoolWait atau fungsi SetThreadpoolWaitEx dengan parameter h diatur ke NULL.
Panggil fungsi WaitForThreadpoolWaitCallbacks dengan parameter fCancelPendingCallbacks yang diatur ke TRUE.
Hubungi CloseThreadpoolWait.

Jika ada grup pembersihan yang terkait dengan objek tunggu, tidak perlu memanggil fungsi ini; memanggil fungsi CloseThreadpoolCleanupGroupMembers merilis objek pekerjaan, tunggu, dan timer yang terkait dengan grup pembersihan.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau lebih tinggi.

Contoh

Misalnya, lihat Menggunakan Fungsi Kumpulan Utas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	threadpoolapiset.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka	Kernel32.lib
DLL	Kernel32.dll