Fungsi DeleteTimerQueueEx (threadpoollegacyapiset.h)

  • Artikel

Menghapus antrean timer. Setiap timer yang tertunda dalam antrean dibatalkan dan dihapus.

Sintaks

BOOL DeleteTimerQueueEx(
  [in]           HANDLE TimerQueue,
  [in, optional] HANDLE CompletionEvent
);

Parameter

[in] TimerQueue

Handel ke antrean timer. Handel ini dikembalikan oleh fungsi CreateTimerQueue .

[in, optional] CompletionEvent

Handel ke objek peristiwa yang akan disinyalkan ketika fungsi berhasil dan semua fungsi panggilan balik telah selesai. Parameter ini bisa NULL.

Jika parameter ini INVALID_HANDLE_VALUE, fungsi menunggu semua fungsi panggilan balik selesai sebelum kembali.

Jika parameter ini NULL, fungsi menandai timer untuk penghapusan dan segera kembali. Namun, sebagian besar penelepon harus menunggu fungsi panggilan balik selesai sehingga mereka dapat melakukan pembersihan yang diperlukan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Jangan melakukan pemblokiran panggilan ke DeleteTimerQueueEx dari dalam panggilan balik timer.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0500 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header threadpoollegacyapiset.h
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

CreateTimerQueue

DeleteTimerQueueTimer

Fungsi Sinkronisasi

Pengumpulan Utas

Antrean Timer