IEventControl::SetDefaultQuery メソッド (eventsys.h)

サブスクライバーを決定する既定のクエリを設定します。

構文

HRESULT SetDefaultQuery(
  [in]          BSTR methodName,
  [in]          BSTR criteria,
  [out, retval] int  *errorIndex
);

パラメーター

[in] methodName

既定のクエリが割り当てられるメソッドの名前。

[in] criteria

クエリ条件。 このパラメーターを NULL にすることはできません。 このパラメーターの有効な式の形成の詳細については、以下の「備考」セクションを参照してください。

[out, retval] errorIndex

criteria パラメーター内のエラーの位置をオフセットとして表します。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

criteria パラメーターで指定されるクエリ条件は、"ALL" にするか、すべてのサブスクリプション オブジェクトに対する要求を指定するか、サブスクリプション オブジェクトがクエリ結果に含めるために満たす必要がある 1 つ以上の条件を示すブール式にすることができます。 有効な式は次の形式です。

[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'"

要件

関連項目

IEventControl