CancelQuery 方法

描述

每当逻辑事件使用者使用Windows Management取消相关事件查询过滤器时，调用IWbemEventProviderQuerySink.CancelQuery方法。CancelQuery方法确定事件提供者如何响应相关的已取消事件查询过滤器。每当WMI从消费者中检索事件查询过滤器的取消通知时，WMI将调用CancelQuery以将取消回应给负责的事件提供者。事件提供者可以检查查询的标识符，以确定正在取消哪个查询。然后，提供商根据取消修改正在发送哪些事件。

C++ 语法

HRESULT CancelQuery(

[in] unsigned long dwId

);

PowerBASIC 语法

METHOD CancelQuery ( _

BYVAL dwId AS DWORD _

) AS LONG

参数

dwId

被取消的查询的标识符。该标识符最初通过此接口的NewQuery方法传递给提供商。

返回值

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

退货代码	描述
WBEM_S_NO_ERROR	提供者应该返回此结果。

备注

每当消费者注册新的事件查询过滤器时，Windows Management将使用查询标识符调用IWbemEventProviderQuerySink.NewQuery方法。稍后，当该查询未注册时，将调用此方法，指示哪个查询不再出色。

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

要求

客户	需要Windows Vista，Windows XP，Windows 2000 Professional，Windows NT Workstation 4.0 SP4及更高版本，Windows Me，Windows 98或Windows 95。
服务器	需要Windows Server 2008，Windows Server 2003，Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。
头	在Wbemprov.inc中声明。
DLL	需要Wbemsvc.dll。