Поделиться через


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

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

Синтаксис

typedef enum _EVT_SEEK_FLAGS {
  EvtSeekRelativeToFirst = 1,
  EvtSeekRelativeToLast = 2,
  EvtSeekRelativeToCurrent = 3,
  EvtSeekRelativeToBookmark = 4,
  EvtSeekOriginMask = 7,
  EvtSeekStrict = 0x10000
} EVT_SEEK_FLAGS;

Константы

 
EvtSeekRelativeToFirst
Значение: 1
Ищите указанное смещение из первой записи в результирующем наборе. Смещение должно быть положительным значением.
EvtSeekRelativeToLast
Значение: 2
Ищите указанное смещение от последней записи в результирующем наборе. Смещение должно быть отрицательным значением.
EvtSeekRelativeToCurrent
Значение: 3
Ищите указанное смещение из текущей записи в результирующем наборе. Смещение может быть положительным или отрицательным значением.
EvtSeekRelativeToBookmark
Значение: 4
Ищите указанное смещение из записи в закладках в результирующем наборе. Смещение может быть положительным или отрицательным значением.
EvtSeekOriginMask
Значение: 7
Битовая маска, с помощью которой можно определить, какой из следующих флагов установлен:


  • EvtSeekRelativeToFirst

  • EvtSeekRelativeToLast

  • EvtSeekRelativeToBookmark

EvtSeekStrict
Значение: 0x10000
Принудительная ошибка функции, если событие не существует.

Комментарии

Если смещение или закладка выполняет поиск за границей результирующих наборов (за первой или последней записью), а Параметр EvtSeekStrict не задан, функция seek вернет последнюю запись в пределах границы.

Если закладка находится в пределах результирующих наборов (на основе идентификатора записи события), но не включена в результирующий набор, функция seek применит смещение относительно идентификатора записи закладки. В следующей таблице в первом столбце показаны идентификаторы записей событий в результирующем наборе. Если идентификатор записи закладки равен 3989, во втором столбце отображается запись, к которому будет стремиться функция поиска с учетом указанного смещения.

Идентификатор записи Offset
3995 –2
3991 –1
3987 0, 1
3983 2
3979 3
3975 4
3971 5
3968 6
3959 7
3955 8

Требования

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

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

EvtSeek