IWbemEventProviderQuerySink：：CancelQuery 方法 (wbemprov.h)

  • 项目

每当逻辑事件使用者使用 Windows Management 取消相关事件查询筛选器时，调用 IWbemEventProviderQuerySink：：CancelQuery 方法。 CancelQuery 方法确定事件提供程序如何响应相关的已取消事件查询筛选器。 每当 WMI 从使用者检索事件查询筛选器的取消通知时，WMI 会调用 CancelQuery 以将取消回显到负责的事件提供程序。 事件提供程序可以检查查询的标识符，以确定要取消的查询。 然后，提供程序根据取消修改要发送的事件。

语法

HRESULT CancelQuery(
  [in] unsigned long dwId
);

参数

[in] dwId

已取消的查询的标识符。 此标识符最初通过此接口的 NewQuery 方法传递到提供程序。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。

注解

每当使用者注册新的事件查询筛选器时，Windows 管理会使用查询标识符调用 IWbemEventProviderQuerySink：：NewQuery 方法。 稍后，当取消注册该查询时，将调用此方法，指示哪个查询不再未完成。

提供程序使用此方法来帮助优化内部事件的生成。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemprov.h (包括 Wbemidl.h)
Library Wbemuuid.lib
DLL Wbemsvc.dll

另请参阅

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink：：NewQuery