IWbemEventProviderQuerySink::CancelQuery, méthode (wbemprov.h)

Appelez la méthode IWbemEventProviderQuerySink::CancelQuery chaque fois qu’un consommateur d’événements logiques annule un filtre de requête d’événement approprié avec Windows Management. La méthode CancelQuery détermine la façon dont un fournisseur d’événements répond à un filtre de requête d’événement annulé approprié. Chaque fois que WMI récupère un avis d’annulation pour un filtre de requête d’événement auprès d’un consommateur, WMI appelle CancelQuery pour faire écho à l’annulation au fournisseur d’événements responsable. Le fournisseur d’événements peut examiner l’identificateur de la requête pour déterminer la requête en cours d’annulation. Le fournisseur modifie ensuite les événements qui sont envoyés en fonction de l’annulation.

Syntaxe

HRESULT CancelQuery(
  [in] unsigned long dwId
);

Paramètres

[in] dwId

Identificateur de la requête qui a été annulée. Cet identificateur a été initialement remis au fournisseur par la méthode NewQuery de cette interface.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Remarques

Chaque fois qu’un consommateur inscrit un nouveau filtre de requête d’événement, Windows Management appelle la méthode IWbemEventProviderQuerySink::NewQuery avec l’identificateur de requête. Plus tard, lorsque cette requête est désinscrit, cette méthode est appelée pour indiquer quelle requête n’est plus en attente.

Les fournisseurs utilisent cette méthode pour optimiser la génération d’événements en interne.

Configuration requise

Voir aussi

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery