Метод IWbemEventProviderQuerySink::CancelQuery (wbemprov.h)

Вызовите метод IWbemEventProviderQuerySink::CancelQuery всякий раз, когда потребитель логического события отменяет соответствующий фильтр запросов событий с помощью управления Windows. Метод CancelQuery определяет, как поставщик событий реагирует на соответствующий фильтр запросов отмененных событий. Всякий раз, когда WMI получает уведомление об отмене для фильтра запроса событий от потребителя, WMI вызывает CancelQuery , чтобы повторить отмену ответственному поставщику событий. Поставщик событий может проверить идентификатор запроса, чтобы определить, какой запрос отменяется. Затем поставщик изменяет, какие события отправляются в зависимости от отмены.

Синтаксис

HRESULT CancelQuery(
  [in] unsigned long dwId
);

Параметры

[in] dwId

Идентификатор отмененного запроса. Этот идентификатор изначально был доставлен поставщику методом NewQuery этого интерфейса.

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT.

Комментарии

Всякий раз, когда потребитель регистрирует новый фильтр запроса событий, управление Windows вызывает метод IWbemEventProviderQuerySink::NewQuery с идентификатором запроса. Позже, когда этот запрос отменяется, вызывается этот метод, указывающий, какой запрос больше не является невыполненным.

Поставщики используют этот метод для внутренней оптимизации создания событий.

Требования

Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemprov.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Wbemsvc.dll

См. также раздел

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery