다음을 통해 공유

EVT_QUERY_FLAGS 열거형(winevt.h)

  • 아티클

쿼리 결과를 반환하는 방법과 채널 또는 로그 파일에 대해 쿼리할지 여부를 지정하는 값을 정의합니다.

Syntax

typedef enum _EVT_QUERY_FLAGS {
  EvtQueryChannelPath = 0x1,
  EvtQueryFilePath = 0x2,
  EvtQueryForwardDirection = 0x100,
  EvtQueryReverseDirection = 0x200,
  EvtQueryTolerateQueryErrors = 0x1000
} EVT_QUERY_FLAGS;

상수

 
EvtQueryChannelPath
값: 0x1
쿼리가 하나 이상의 채널에 대해 되도록 지정합니다. EvtQuery 함수의 Path 매개 변수는 채널 또는 NULL의 이름을 지정해야 합니다.
EvtQueryFilePath
값: 0x2
쿼리가 하나 이상의 로그 파일에 대해 되도록 지정합니다. EvtQuery 함수의 Path 매개 변수는 로그 파일 또는 NULL에 대한 전체 경로를 지정해야 합니다.
EvtQueryForwardDirection
값: 0x100
쿼리 결과의 이벤트가 가장 오래된 이벤트부터 최신 이벤트로 정렬되도록 지정합니다. 이것이 기본값입니다.
EvtQueryReverseDirection
값: 0x200
쿼리 결과의 이벤트가 최신에서 가장 오래된 이벤트로 정렬되도록 지정합니다.
EvtQueryTolerateQueryErrors
값: 0x1000
쿼리의 일부가 오류를 발생시키는 경우에도 EvtQuery 에서 쿼리를 실행해야 한다고 지정합니다(형식이 잘못됨). 서비스는 XPath 쿼리 구문의 유효성을 검사하여 올바른 형식인지 확인합니다. 유효성 검사에 실패하면 서비스는 XPath를 개별 식으로 구문 분석합니다. 가장 왼쪽의 식으로 시작하는 새 XPath를 빌드합니다. 서비스는 식의 유효성을 검사하고 유효한 경우 서비스는 XPath에 다음 식을 추가합니다. 서비스는 실패하는 식을 발견할 때까지 이 프로세스를 반복합니다. 그런 다음 맨 왼쪽 식을 XPath 쿼리로 시작하는 유효한 식을 사용합니다(즉, 예상한 이벤트를 가져올 수 없음). XPath의 일부가 유효하지 않으면 EvtQuery 호출이 실패합니다.

설명

EvtQueryChannelPath 및 EvtQueryFilePath 플래그는 상호 배타적입니다. EvtQueryForwardDirection 및 EvtQueryReverseDirection 플래그도 상호 배타적입니다.

디버그 및 분석 채널과 .evt 및 .etl 로그 파일에서만 정방향으로 이벤트를 검색할 수 있습니다.

요구 사항

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

추가 정보

EvtQuery