Share via

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