Share via

перечисление EVT_SUBSCRIBE_FLAGS (winevt.h)

  • Статья

Определяет возможные значения, указывающие, когда следует начать подписку на события.

Синтаксис

typedef enum _EVT_SUBSCRIBE_FLAGS {
  EvtSubscribeToFutureEvents = 1,
  EvtSubscribeStartAtOldestRecord = 2,
  EvtSubscribeStartAfterBookmark = 3,
  EvtSubscribeOriginMask = 3,
  EvtSubscribeTolerateQueryErrors = 0x1000,
  EvtSubscribeStrict = 0x10000
} EVT_SUBSCRIBE_FLAGS;

Константы

 
EvtSubscribeToFutureEvents
Значение: 1
Подпишитесь только на будущие события, которые соответствуют критериям запроса.
EvtSubscribeStartAtOldestRecord
Значение: 2
Подпишитесь на все существующие и будущие события, соответствующие критериям запроса.
EvtSubscribeStartAfterBookmark
Значение: 3
Подпишитесь на все существующие и будущие события, соответствующие критериям запроса, которые начинаются после события закладки. Если включить флаг EvtSubscribeStrict, функция EvtSubscribe завершается ошибкой, если событие закладки не существует. Если флаг EvtSubscribeStrict не включен, а событие закладки не существует, подписка начинается с события, которое находится после события, ближайшего к событию закладки.
EvtSubscribeOriginMask
Значение: 3
Битовая маска, с помощью которой можно определить, какой из следующих флагов установлен:


  • EvtSubscribeToFutureEvents

  • EvtSubscribeStartAtOldestRecord

  • EvtSubscribeStartAfterBookmark
EvtSubscribeTolerateQueryErrors
Значение: 0x1000
Завершите подписку, даже если часть запроса создает ошибку (неправильно сформирована). Служба проверяет синтаксис запроса XPath, чтобы определить, правильно ли он сформирован. Если проверка завершается сбоем, служба анализирует XPath в отдельные выражения. Он создает новый XPath, начинающийся с самого левого выражения. Служба проверяет выражение и, если оно допустимо, служба добавляет следующее выражение в XPath. Служба повторяет этот процесс, пока не найдет выражение, которое завершается сбоем. Затем в запросе XPath используются допустимые выражения, начинающиеся с крайнего левого выражения (это означает, что вы можете не получить ожидаемые события). Если ни часть XPath не является допустимой, вызов EvtSubscribe завершается ошибкой .
EvtSubscribeStrict
Значение: 0x10000
Вызов EvtSubscribe завершается ошибкой, если указан параметр EvtSubscribeStartAfterBookmark и событие закладки не найдено (возвращаемое значение равно ERROR_NOT_FOUND). Кроме того, установите этот флаг, если вы хотите получать уведомления в обратном вызове при отсутствии записей событий.

Комментарии

Флаги EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord и EvtSubscribeStartAfterBookmark являются взаимоисключающими.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть winevt.h

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

EvtSubscribe