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 |