Метод IEventControl::SetDefaultQuery (eventsys.h)

  • Статья

Задает запрос по умолчанию для определения подписчиков.

Синтаксис

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

Параметры

[in] methodName

Имя метода, которому назначен запрос по умолчанию.

[in] criteria

Условия запроса. Этот параметр не может иметь значение NULL. Дополнительные сведения о формировании допустимого выражения для этого параметра см. в разделе Примечания ниже.

[out, retval] errorIndex

Расположение ошибки в параметре условия , выраженное в виде смещения.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Критерии запроса, заданные параметром criteria , могут быть "ALL", чтобы указать запрос для всех объектов подписки, или логическое выражение, обозначающее одно или несколько условий, которым должен соответствовать объект подписки для включения в результат запроса. Допустимые выражения имеют следующую форму:

[НЕ] propertynamerelationalOperatorvalue. Допустимые реляционные операторы:

==, =, !=, <>, ~=. Допустимые значения: 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 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header eventsys.h

См. также раздел

IEventControl