TraceQueryInformation 함수(evntrace.h)
TraceQueryInformation 함수는 이벤트 추적 세션에 대한 정보를 제공합니다.
구문
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를 호출한 후 이 함수를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 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 |