Fungsi CloseThreadpoolWait (threadpoolapiset.h)
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 |