共用方式為


IWbemEventProviderQuerySink::CancelQuery 方法 (wbemprov.h)

每當邏輯事件取用者使用 Windows 管理取消相關的事件查詢篩選時,呼叫 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)
程式庫 Wbemuuid.lib
Dll Wbemsvc.dll

另請參閱

IWbemEventProviderQuerySink

IWbemEventProviderQuerySink::NewQuery