EvtGetEventInfo 함수(winevt.h)

이벤트를 선택한 구조적 XML 쿼리와 이벤트가 포함된 채널 또는 로그 파일을 식별하는 정보를 가져옵니다.

구문

BOOL EvtGetEventInfo(
  [in]  EVT_HANDLE            Event,
  [in]  EVT_EVENT_PROPERTY_ID PropertyId,
  [in]  DWORD                 PropertyValueBufferSize,
  [in]  PEVT_VARIANT          PropertyValueBuffer,
  [out] PDWORD                PropertyValueBufferUsed
);

매개 변수

[in] Event

정보를 검색하려는 이벤트에 대한 핸들입니다.

[in] PropertyId

검색할 정보를 식별하는 플래그입니다. 예를 들어 쿼리 식별자 또는 경로입니다. 가능한 값은 EVT_EVENT_PROPERTY_ID 열거형을 참조하세요.

[in] PropertyValueBufferSize

PropertyValueBuffer 버퍼의 크기(바이트)입니다.

[in] PropertyValueBuffer

정보를 수신할 호출자가 할당한 버퍼입니다. 버퍼에는 EVT_VARIANT 개체가 포함됩니다. 이 매개 변수를 NULL 로 설정하여 필요한 버퍼 크기를 확인할 수 있습니다.

[out] PropertyValueBufferUsed

함수가 사용한 호출자 할당 버퍼의 크기(바이트)이거나 함수가 ERROR_INSUFFICIENT_BUFFER 실패하는 경우 필요한 버퍼 크기입니다.

반환 값

반환 코드/값	설명
TRUE	함수가 성공했습니다.
FALSE	함수가 실패했습니다. GetLastError 함수를 사용하여 오류 코드를 가져옵니다.

설명

EvtQuery 또는 EvtSubscribe에 전달한 쿼리가 구조적 XML 쿼리 대신 XPath인 경우 쿼리 식별자는 0이 되고 경로는 함수에 전달된 경로가 됩니다.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winevt.h
라이브러리	Wevtapi.lib
DLL	Wevtapi.dll