перечисление 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 Битовая маска, с помощью которой можно определить, какой из следующих флагов установлен:
|
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 |