다음을 통해 공유

EVT_SUBSCRIBE_FLAGS 열거형(winevt.h)

  • 아티클

이벤트 구독을 시작할 시기를 지정하는 가능한 값을 정의합니다.

Syntax

typedef enum _EVT_SUBSCRIBE_FLAGS {
  EvtSubscribeToFutureEvents = 1,
  EvtSubscribeStartAtOldestRecord = 2,
  EvtSubscribeStartAfterBookmark = 3,
  EvtSubscribeOriginMask = 3,
  EvtSubscribeTolerateQueryErrors = 0x1000,
  EvtSubscribeStrict = 0x10000
} EVT_SUBSCRIBE_FLAGS;

상수

 
EvtSubscribeToFutureEvents
값: 1
쿼리 조건과 일치하는 이후 이벤트만 구독합니다.
EvtSubscribeStartAtOldestRecord
값: 2
쿼리 조건과 일치하는 모든 기존 및 이후 이벤트를 구독합니다.
EvtSubscribeStartAfterBookmark
값: 3
책갈피가 지정된 이벤트 이후에 시작되는 쿼리 조건과 일치하는 모든 기존 및 이후 이벤트를 구독합니다. EvtSubscribeStrict 플래그를 포함하면 책갈피가 지정된 이벤트가 없으면 EvtSubscribe 함수가 실패합니다. EvtSubscribeStrict 플래그를 포함하지 않고 책갈피가 지정된 이벤트가 없는 경우 구독은 책갈피가 지정된 이벤트에 가장 가까운 이벤트 다음에 있는 이벤트로 시작합니다.
EvtSubscribeOriginMask
값: 3
다음 플래그 중 어떤 플래그가 설정되었는지 확인하는 데 사용할 수 있는 비트 마스크입니다.


  • EvtSubscribeToFutureEvents

  • EvtSubscribeStartAtOldestRecord

  • EvtSubscribeStartAfterBookmark
EvtSubscribeTolerateQueryErrors
값: 0x1000
쿼리의 일부에서 오류가 발생하더라도(잘 구성되지 않음) 구독을 완료합니다. 서비스는 XPath 쿼리 구문의 유효성을 검사하여 올바른 형식인지 확인합니다. 유효성 검사에 실패하면 서비스는 XPath를 개별 식으로 구문 분석합니다. 가장 왼쪽의 식으로 시작하는 새 XPath를 빌드합니다. 서비스는 식의 유효성을 검사하고 유효한 경우 서비스는 XPath에 다음 식을 추가합니다. 서비스는 실패하는 식을 발견할 때까지 이 프로세스를 반복합니다. 그런 다음 맨 왼쪽 식을 XPath 쿼리로 시작하는 유효한 식을 사용합니다(즉, 예상한 이벤트를 가져올 수 없음). XPath의 일부가 유효하지 않으면 EvtSubscribe 호출이 실패합니다.
EvtSubscribeStrict
값: 0x10000
EvtSubscribeStartAfterBookmark를 지정하고 책갈피가 지정된 이벤트를 찾을 수 없는 경우 EvtSubscribe 호출이 실패하도록 합니다(반환 값은 ERROR_NOT_FOUND). 또한 이벤트 레코드가 누락된 경우 콜백에서 알림을 받으려면 이 플래그를 설정합니다.

설명

EvtSubscribeToFutureEvents, EvtSubscribeStartAtOldestRecord 및 EvtSubscribeStartAfterBookmark 플래그는 상호 배타적입니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 winevt.h

추가 정보

EvtSubscribe