IWbemServices：：ExecNotificationQuery 方法 (wbemcli.h)

發行項
03/03/2024

IWbemServices：：ExecNotificationQuery 方法會執行查詢來接收事件。呼叫會立即傳回，而且用戶可以在抵達時輪詢傳回的事件列舉值。釋放傳回的列舉值會取消查詢。

語法

HRESULT ExecNotificationQuery(
  [in]  const BSTR           strQueryLanguage,
  [in]  const BSTR           strQuery,
  [in]  long                 lFlags,
  [in]  IWbemContext         *pCtx,
  [out] IEnumWbemClassObject **ppEnum
);

參數

[in] strQueryLanguage

有效的 BSTR ，其中包含 Windows 管理所支援的其中一種查詢語言。這不可以是 NULL。目前僅支援 WMI 查詢語言 (WQL) 。

[in] strQuery

包含事件相關查詢文字的有效 BSTR 。這不可以是 NULL。如需建置 WMI 查詢字串的詳細資訊，請參閱使用 WQL 查詢和 WQL 參考。

[in] lFlags

此參數必須同時設定為 WBEM_FLAG_RETURN_IMMEDIATELY 和 WBEM_FLAG_FORWARD_ONLY ，否則呼叫會失敗。

WBEM_FLAG_FORWARD_ONLY

此旗標會導致傳回順向列舉值。順向列舉值通常更快，而且使用記憶體比傳統列舉值少，但不允許呼叫 Clone 或 Reset。

WBEM_FLAG_RETURN_IMMEDIATELY

用戶必須指定此旗標，否則呼叫會失敗。這是因為會持續收到事件，這表示使用者必須輪詢傳回的列舉值。無限期地封鎖此呼叫，同時等候可能的事件會封鎖線程無限期的時間。如需詳細資訊，請參閱呼叫方法。

[in] pCtx

通常 為 NULL。否則，這是 IWbemContext 物件的指標，可供提供所要求事件的提供者使用。內容物件中的值必須在有問題的提供者檔中指定。如需此參數的詳細資訊，請參閱呼叫 WMI。

[out] ppEnum

如果沒有發生錯誤，此參數會接收列舉值，讓呼叫端擷取查詢結果集中的實例。呼叫端會定期呼叫 IEnumWbemClassObject：：Next 以查看是否有任何事件可用。請注意，在此用法中， Reset 不會將列舉值移回事件順序的開頭;它沒有任何作用。參數可以繼續接收事件，直到在傳回的列舉值上呼叫 Release 為止。

傳回值

這個方法會傳回 HRESULT ，指出方法呼叫的狀態。下列清單列出 HRESULT 中包含的值。

失敗時，您可以從 COM 函式 GetErrorInfo 取得任何可用資訊。

如果網路問題造成您失去與 Windows 管理的遠端連線，也可以傳回 COM 特定的錯誤碼。

備註

WQL 查詢中可以使用 的 AND 和 OR 關鍵詞數目有一些限制。複雜查詢中使用的大量 WQL 關鍵詞可能會導致 WMI 將WBEM_E_QUOTA_VIOLATION錯誤碼傳回為 HRESULT 值。 WQL 關鍵字的限制取決於查詢的複雜程度。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	wbemcli.h (包含 Wbemidl.h)
程式庫	Wbemuuid.lib
Dll	Fastprox.dll;Esscli.dll;FrameDyn.dll;FrameDynOS.dll;Ntevt.dll;Stdprov.dll;Viewprov.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wbemsvc.dll;Wmipicmp.dll;Wmidcprv.dll;Wmipjobj.dll;Wmiprvsd.dll