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


Функция 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

Количество заданных дескрипторов в массиве.

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

Возвращаемый код/значение Описание
TRUE
Функция выполнена успешно.
FALSE
Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError .

Комментарии

Вызывайте эту функцию в цикле, пока функция не вернет значение FALSE , а код ошибки не будет ERROR_NO_MORE_ITEMS.

Для каждого извлекаемого события можно вызвать функции EvtCreateRenderContext и EvtRender для отрисовки события.

Необходимо вызывать EvtClose для каждого получаемого дескриптора события.

Примеры

Пример использования этой функции см. в разделах Запрос событий и Подписка на события.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header winevt.h
Библиотека Wevtapi.lib
DLL Wevtapi.dll

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

EvtQuery

EvtSeek

EvtSubscribe