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 |