Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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 |