Fungsi UnregisterWait (winbase.h)
Membatalkan operasi tunggu terdaftar yang dikeluarkan oleh fungsi RegisterWaitForSingleObject .
Untuk menggunakan peristiwa penyelesaian, panggil fungsi UnregisterWaitEx .
Sintaks
BOOL UnregisterWait(
[in] HANDLE WaitHandle
);
Parameter
[in] WaitHandle
Handel tunggu. Handel ini dikembalikan oleh fungsi RegisterWaitForSingleObject .
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
Jika ada fungsi panggilan balik yang terkait dengan timer belum selesai saat UnregisterWait dipanggil, UnregisterWait membatalkan pendaftaran tunggu pada fungsi panggilan balik dan gagal dengan kode kesalahan ERROR_IO_PENDING . Kode kesalahan tidak menunjukkan bahwa fungsi telah gagal, dan fungsi tidak perlu dipanggil lagi. Jika kode Anda memerlukan kode kesalahan untuk diatur hanya ketika operasi pembatalan pendaftaran gagal, panggil UnregisterWaitEx sebagai gantinya.
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 | winbase.h (termasuk Windows.h) |
Pustaka | Kernel32.lib |
DLL | Kernel32.dll |