Metodo IWbemEventProviderQuerySink::CancelQuery (wbemprov.h)

Chiamare il metodo IWbemEventProviderQuerySink::CancelQuery ogni volta che un consumer di eventi logici annulla un filtro di query evento pertinente con Gestione Windows. Il metodo CancelQuery determina il modo in cui un provider di eventi risponde a un filtro di query evento annullato pertinente. Ogni volta che WMI recupera un avviso di annullamento per un filtro di query evento da un consumer, WMI chiama CancelQuery per eco l'annullamento al provider di eventi responsabile. Il provider di eventi può esaminare l'identificatore della query per determinare quale query viene annullata. Il provider modifica quindi gli eventi inviati in base all'annullamento.

Sintassi

HRESULT CancelQuery(
  [in] unsigned long dwId
);

Parametri

[in] dwId

Identificatore della query annullata. Questo identificatore è stato originariamente recapitato al provider dal metodo NewQuery di questa interfaccia.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT.

Commenti

Ogni volta che un consumer registra un nuovo filtro di query evento, Gestione Windows chiama il metodo IWbemEventProviderQuerySink::NewQuery con l'identificatore di query. Successivamente, quando la query non è registrata, questo metodo viene chiamato che indica quale query non è più in sospeso.

I provider usano questo metodo per ottimizzare la generazione di eventi internamente.

Requisiti

Vedi anche

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery