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
程式庫	Wevtapi.lib
Dll	Wevtapi.dll

另請參閱

EvtQuery

EvtSeek

EvtSubscribe