Fungsi CloseThreadpoolTimer (threadpoolapiset.h)

Artikel
03/04/2024

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