共用方式為

IMultiInterfaceEventControl：：SetDefaultQuery 方法 (eventsys.h)

  • 發行項

建立發行者篩選與事件方法無關時要使用的預設查詢。

語法

HRESULT SetDefaultQuery(
  [in]          REFIID eventIID,
  [in]          BSTR   bstrMethodName,
  [in]          BSTR   bstrCriteria,
  [out, retval] int    *errorIndex
);

參數

[in] eventIID

引發介面的介面識別碼。

[in] bstrMethodName

指派預設查詢的方法名稱。

[in] bstrCriteria

指定查詢準則的字串。 此參數不可為 Null。 如需為此參數形成有效運算式的詳細資訊，請參閱下面的一節。

[out, retval] errorIndex

以位移表示的 bstrCriteria 參數中錯誤的位置。

傳回值

這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED和E_FAIL，以及下列值。

傳回碼 描述
S_OK
 已成功完成命令。
EVENT_E_QUERYSYNTAX
 嘗試評估查詢字串時發生語法錯誤。
EVENT_E_QUERYFIELD
 查詢字串中使用不正確功能變數名稱。
EVENT_E_INTERNALEXCEPTION
 引發未預期的例外狀況。
EVENT_E_INTERNALERROR
 偵測到非預期的內部錯誤。

備註

這個方法是 IEventSystem：：Query 方法的更特製化形式。 除了只取得訂閱物件之外，每當訂閱集合變更時，呼叫 GetSubscriptions 取得的 集合也會自動更新。

bstrCriteria參數指定的查詢準則可以是 「ALL」，以指定所有訂閱物件的要求，或表示訂閱物件必須符合的一或多個條件的布林運算式，才能包含在查詢結果中。 有效運算式的格式如下：

[NOT] propertynamerelationalOperator值。 有效的關係運算子如下所示：

==, =, !=, <>, ~=. 有效值為 「string」、「string'、{GUID}、 TRUE、 FALSE、 Null。

個別布林運算式可以與 AND 或 OR 聯結。 運算式可以巢狀在括弧中，以強制執行特定的評估順序。

以下是有效查詢準則的一些範例：

「EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF}」

「EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF} AND MethodName = 'StockPriceChange'」

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 eventsys.h

另請參閱

IMultiInterfaceEventControl