Metode IWbemEventProviderQuerySink::CancelQuery (wbemprov.h)
Panggil metode IWbemEventProviderQuerySink::CancelQuery setiap kali konsumen peristiwa logis membatalkan filter kueri peristiwa yang relevan dengan Manajemen Windows. Metode CancelQuery menentukan bagaimana penyedia peristiwa merespons filter kueri peristiwa yang dibatalkan yang relevan. Setiap kali WMI mengambil pemberitahuan pembatalan untuk filter kueri peristiwa dari konsumen, WMI memanggil CancelQuery untuk menggemakan pembatalan ke penyedia peristiwa yang bertanggung jawab. Penyedia peristiwa dapat memeriksa pengidentifikasi kueri untuk menentukan kueri mana yang dibatalkan. Penyedia kemudian memodifikasi peristiwa mana yang dikirim berdasarkan pembatalan.
Sintaks
HRESULT CancelQuery(
[in] unsigned long dwId
);
Parameter
[in] dwId
Pengidentifikasi kueri yang dibatalkan. Pengidentifikasi ini awalnya dikirimkan ke penyedia dengan metode NewQuery antarmuka ini.
Nilai kembali
Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.
Keterangan
Setiap kali konsumen mendaftarkan filter kueri peristiwa baru, Manajemen Windows memanggil metode IWbemEventProviderQuerySink::NewQuery dengan pengidentifikasi kueri. Kemudian, ketika kueri tersebut tidak terdaftar, metode ini disebut menunjukkan kueri mana yang tidak lagi beredar.
Penyedia menggunakan metode ini untuk membantu mengoptimalkan pembuatan peristiwa secara internal.
Persyaratan
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | wbemprov.h (termasuk Wbemidl.h) |
| Pustaka | Wbemuuid.lib |
| DLL | Wbemsvc.dll |