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”,可以指定对所有订阅对象的请求,也可以是一个布尔表达式,表示订阅对象必须满足一个或多个条件才能包含在查询结果中。 有效表达式的形式如下:

[NOT] propertynamerelationalOperator。 有效的关系运算符如下所示:

==, =, !=, <>, ~=. 有效值为“string”、“string”、{GUID}、 TRUEFALSENULL

单个布尔表达式可与 AND 或 OR 联接。 表达式可以嵌套在括号中,以强制实施特定计算顺序。

下面是一些有效查询条件的示例:

“EventClassID == {F89859D1-6565-11D1-88C8-0080C7D771BF}”

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

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 eventsys.h

请参阅

IEventControl