IEventSystem：：QueryS 方法 (eventsys.h)

從事件資料存放區擷取訂閱或事件物件的集合。

語法

HRESULT QueryS(
  [in]          BSTR     progID,
  [in]          BSTR     queryCriteria,
  [out, retval] IUnknown **ppInterface
);

[in] progID

要查詢之物件類別的 ProgID。這必須是有效的事件物件類別識別碼。此參數可以是下列其中一個值：

[in] queryCriteria

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

[out, retval] ppInterface

查詢結果所取得之物件的指標位址。此參數不可為 Null。視 progID 參數所指定的物件而定，這是下列其中一個介面的指標：

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

呼叫端負責釋放透過 ppInterface 參數配置的記憶體。

queryCriteria參數指定的查詢準則可以是「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'」