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

예약되어 있습니다. 0이어야 합니다.

[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