TraceQueryInformation 함수(evntrace.h)

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

Syntax

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

매개 변수

TraceId

[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를 호출한 후 이 함수를 호출합니다.

요구 사항

참고하십시오

TRACE_QUERY_INFO_CLASS

TraceSetInformation