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
标头	winevt.h
Library	Wevtapi.lib
DLL	Wevtapi.dll

另请参阅

EvtQuery

EvtSeek

EvtSubscribe