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