EvtGetExtendedStatus 함수(winevt.h)

현재 오류에 대한 확장된 오류 정보가 포함된 문자 메시지를 가져옵니다.

구문

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

매개 변수

[in] BufferSize

버퍼 버퍼의 크기(문자)입니다.

[in] Buffer

확장 오류 정보를 수신할 호출자가 할당한 문자열 버퍼입니다. 이 매개 변수를 NULL 로 설정하여 필요한 버퍼 크기를 확인할 수 있습니다.

[out] BufferUsed

함수가 사용한 호출자 할당 버퍼의 크기(문자 단위) 또는 함수가 ERROR_INSUFFICIENT_BUFFER 실패하는 경우 필요한 버퍼 크기입니다.

반환 값

호출이 성공하면 반환 값이 ERROR_SUCCESS. 그렇지 않으면 Win32 오류 코드입니다.

설명

오류를 생성한 스레드와 다른 Windows 이벤트 로그 함수를 호출하기 전에 이 함수를 호출해야 합니다.

EvtQuery 및 EvtSubscribe 함수는 지정된 XPath에 문제가 있는 경우 확장된 오류 정보를 제공할 수 있습니다. 예를 들어 오류 정보는 구문 분석 오류가 발생한 XPath의 문자를 식별할 수 있습니다. 잘못된 형식의 XPath에 대한 확장 오류 정보를 수신하려면 EvtQuery 또는 EvtSubscribe를 호출할 때 EvtQueryTolerateQueryErrors 플래그를 지정할 수 없습니다.

요구 사항

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