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

Lihat juga

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery