Método IWbemEventProviderQuerySink::CancelQuery (wbemprov.h)
Chame o método IWbemEventProviderQuerySink::CancelQuery sempre que um consumidor de evento lógico cancelar um filtro de consulta de evento relevante com o Gerenciamento do Windows. O método CancelQuery determina como um provedor de eventos responde a um filtro de consulta de evento cancelado relevante. Sempre que o WMI recupera um aviso de cancelamento para um filtro de consulta de evento de um consumidor, o WMI chama CancelQuery para ecoar o cancelamento para o provedor de eventos responsável. O provedor de eventos pode examinar o identificador da consulta para determinar qual consulta está sendo cancelada. Em seguida, o provedor modifica quais eventos estão sendo enviados com base no cancelamento.
Sintaxe
HRESULT CancelQuery(
[in] unsigned long dwId
);
Parâmetros
[in] dwId
Identificador da consulta que foi cancelada. Esse identificador foi originalmente entregue ao provedor pelo método NewQuery dessa interface.
Retornar valor
Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.
Comentários
Sempre que um consumidor registra um novo filtro de consulta de evento, o Gerenciamento do Windows chama o método IWbemEventProviderQuerySink::NewQuery com o identificador de consulta. Posteriormente, quando essa consulta não for registrada, esse método será chamado indicando qual consulta não está mais pendente.
Os provedores usam esse método para ajudar a otimizar a geração de eventos internamente.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wbemprov.h (include Wbemidl.h) |
| Biblioteca | Wbemuuid.lib |
| DLL | Wbemsvc.dll |