Método IWbemEventProviderQuerySink::CancelQuery (wbemprov.h)

Llame al método IWbemEventProviderQuerySink::CancelQuery cada vez que un consumidor de eventos lógico cancela un filtro de consulta de eventos pertinente con Administración de Windows. El método CancelQuery determina cómo responde un proveedor de eventos a un filtro de consulta de eventos cancelado pertinente. Cada vez que WMI recupera un aviso de cancelación para un filtro de consulta de eventos de un consumidor, WMI llama a CancelQuery para hacer eco de la cancelación al proveedor de eventos responsable. El proveedor de eventos puede examinar el identificador de la consulta para determinar qué consulta se está cancelando. A continuación, el proveedor modifica los eventos que se envían en función de la cancelación.

Sintaxis

HRESULT CancelQuery(
  [in] unsigned long dwId
);

Parámetros

[in] dwId

Identificador de la consulta que se canceló. Este identificador se entregó originalmente al proveedor mediante el método NewQuery de esta interfaz.

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Comentarios

Cada vez que un consumidor registra un nuevo filtro de consulta de eventos, La administración de Windows llama al método IWbemEventProviderQuerySink::NewQuery con el identificador de consulta. Más adelante, cuando se anula el registro de esa consulta, se llama a este método que indica qué consulta ya no está pendiente.

Los proveedores usan este método para ayudar a optimizar internamente la generación de eventos.

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemprov.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Wbemsvc.dll

Consulte también

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery