TraceQueryInformation 함수(evntrace.h)

TraceQueryInformation 함수는 이벤트 추적 세션에 대한 정보를 제공합니다.

구문

ULONG WMIAPI TraceQueryInformation(
  [in]            TRACEHANDLE      SessionHandle,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

매개 변수

[in] SessionHandle

정보를 수집하는 이벤트 추적 세션의 핸들입니다. StartTrace 함수는 새 추적이 시작될 때 이 핸들을 반환합니다. 기존 추적의 핸들을 가져오려면 ControlTrace를 사용하여 추적 이름을 기반으로 추적 속성을 쿼리한 다음 반환 EVENT_TRACE_PROPERTIES 된 데이터의 Wnode.HistoricalContext 필드에서 핸들을 가져옵니다.

[in] InformationClass

쿼리할 정보 클래스입니다. 클래스가 캡처하는 정보는 이벤트의 확장된 데이터 섹션에 포함됩니다. 쿼리할 수 있는 정보 클래스 목록은 TRACE_QUERY_INFO_CLASS 열거형을 참조하세요.

[out] TraceInformation

반환된 정보 클래스 특정 데이터를 수신하는 버퍼에 대한 포인터입니다. 정보 클래스는 이 매개 변수의 내용을 결정합니다. 예를 들어 TraceStackTracingInfo 정보 클래스의 경우 이 매개 변수는 CLASSIC_EVENT_ID 구조의 배열입니다. 구조체는 스택 추적이 사용하도록 설정된 이벤트 GUID를 지정합니다. 배열은 256개 요소로 제한됩니다.

[in] InformationLength

TraceInformation 버퍼에 반환된 데이터의 크기(바이트)입니다. 함수가 실패하면 이 값은 필요한 TraceInformation 버퍼의 필요한 크기를 나타냅니다.

[out, optional] ReturnLength

TraceInformation 버퍼에 반환된 특정 데이터의 크기(바이트)를 받는 값의 포인터입니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

• ERROR_BAD_LENGTH

  프로그램이 명령을 실행했지만 명령 길이가 올바르지 않습니다. InformationLength 매개 변수가 최소 크기보다 작은 경우 이 오류가 반환됩니다.

• ERROR_INVALID_PARAMETER

  매개 변수가 올바르지 않습니다.

• ERROR_NOT_SUPPORTED

  요청이 지원되지 않습니다.

• 기타

  FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.

설명

TraceQueryInformation 함수는 추적 세션에서 이벤트 추적 세션 설정을 쿼리합니다. StartTrace를 호출한 후 이 함수를 호출합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	evntrace.h
라이브러리	Windows 8.1 및 Windows Server 2012 R2의 Sechost.lib; Windows 8 및 Windows Server 2012 Advapi32.lib
DLL	Windows 8.1 및 Windows Server 2012 R2에 대한 Sechost.dll, Windows 8 및 Windows Server 2012 대한 Advapi32.dll

추가 정보

TRACE_QUERY_INFO_CLASS

TraceSetInformation