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 |