Функция EvtNext (winevt.h)
Возвращает следующее событие из результатов запроса или подписки.
Синтаксис
BOOL EvtNext(
[in] EVT_HANDLE ResultSet,
[in] DWORD EventsSize,
[in] PEVT_HANDLE Events,
[in] DWORD Timeout,
[in] DWORD Flags,
[out] PDWORD Returned
);
Параметры
[in] ResultSet
Дескриптор результирующий набор запроса или подписки, возвращаемого функцией EvtQuery или функцией EvtSubscribe .
[in] EventsSize
Количество элементов в массиве EventArray . Функция попытается получить это количество элементов из результирующих наборов.
[in] Events
Указатель на массив дескрипторов, который будет установлен в дескрипторах событий из результирующих наборов.
[in] Timeout
Количество миллисекундах, которое вы готовы ждать результата. Задайте значение INFINITE, чтобы указать, что время ожидания не задано. Если истекает время ожидания, для последней ошибки устанавливается значение ERROR_TIMEOUT.
[in] Flags
Зарезервировано. Должен равняться нулю.
[out] Returned
Количество заданных дескрипторов в массиве.
Возвращаемое значение
| Возвращаемый код/значение | Описание |
|---|---|
|
Функция выполнена успешно. |
|
Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError . |
Комментарии
Вызывайте эту функцию в цикле, пока функция не вернет значение FALSE , а код ошибки не будет ERROR_NO_MORE_ITEMS.
Для каждого извлекаемого события можно вызвать функции EvtCreateRenderContext и EvtRender для отрисовки события.
Необходимо вызывать EvtClose для каждого получаемого дескриптора события.
Примеры
Пример использования этой функции см. в разделах Запрос событий и Подписка на события.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winevt.h |
| Библиотека | Wevtapi.lib |
| DLL | Wevtapi.dll |