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 |