Fungsi CloseThreadpoolTimer (threadpoolapiset.h)
Merilis objek timer yang ditentukan.
Sintaks
void CloseThreadpoolTimer(
[in, out] PTP_TIMER pti
);
Parameter
[in, out] pti
Penunjuk ke struktur TP_TIMER yang menentukan objek timer. Fungsi CreateThreadpoolTimer mengembalikan penunjuk ini.
Mengembalikan nilai
Tidak ada
Keterangan
Objek timer segera dibebaskan jika tidak ada panggilan balik yang luar biasa; jika tidak, objek timer dibebaskan secara asinkron setelah fungsi panggilan balik yang luar biasa selesai.
Dalam beberapa kasus, fungsi panggilan balik mungkin berjalan setelah CloseThreadpoolTimer dipanggil. Untuk mencegah perilaku ini:
- Panggil fungsi SetThreadpoolTimer atau fungsi SetThreadpoolTimerEx dengan parameter pftDueTime diatur ke NULL dan parameter msPeriod dan msWindowLength diatur ke 0.
- Panggil fungsi WaitForThreadpoolTimerCallbacks dengan parameter fCancelPendingCallbacks yang diatur ke TRUE.
- Hubungi CloseThreadpoolTimer.
Jika ada grup pembersihan yang terkait dengan objek timer, 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.
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 |