IWbemEventProviderQuerySink::CancelQuery-Methode (wbemprov.h)

Rufen Sie die IWbemEventProviderQuerySink::CancelQuery-Methode auf, wenn ein logischer Ereignis-Consumer einen relevanten Ereignisabfragefilter mit der Windows-Verwaltung abbricht. Die CancelQuery-Methode bestimmt, wie ein Ereignisanbieter auf einen relevanten Filter für abgebrochene Ereignisabfragen reagiert. Wenn WMI eine Abbruchbenachrichtigung für einen Ereignisabfragefilter von einem Consumer abruft, ruft WMI CancelQuery auf, um die Abbruchmeldung an den zuständigen Ereignisanbieter zu echoen. Der Ereignisanbieter kann den Bezeichner der Abfrage untersuchen, um zu bestimmen, welche Abfrage abgebrochen wird. Der Anbieter ändert dann basierend auf dem Abbruch, welche Ereignisse gesendet werden.

Syntax

HRESULT CancelQuery(
  [in] unsigned long dwId
);

Parameter

[in] dwId

Bezeichner der Abfrage, die abgebrochen wurde. Dieser Bezeichner wurde ursprünglich von der NewQuery-Methode dieser Schnittstelle an den Anbieter übermittelt.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Hinweise

Wenn ein Consumer einen neuen Ereignisabfragefilter registriert, ruft die Windows-Verwaltung die IWbemEventProviderQuerySink::NewQuery-Methode mit dem Abfragebezeichner auf. Später, wenn diese Abfrage nicht registriert wird, wird diese Methode aufgerufen, um anzugeben, welche Abfrage nicht mehr aussteht.

Anbieter verwenden diese Methode, um die interne Generierung von Ereignissen zu optimieren.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemprov.h (include Wbemidl.h)
Bibliothek	Wbemuuid.lib
DLL	Wbemsvc.dll

Weitere Informationen

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery