TraceSetInformation 함수(evntrace.h)

TraceSetInformation 함수는 이벤트 추적 세션 설정을 구성합니다.

구문

ULONG WMIAPI TraceSetInformation(
  [in] TRACEHANDLE      SessionHandle,
  [in] TRACE_INFO_CLASS InformationClass,
  [in] PVOID            TraceInformation,
  [in] ULONG            InformationLength
);

매개 변수

[in] SessionHandle

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

[in] InformationClass

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

[in] TraceInformation

정보 클래스 특정 데이터에 대한 포인터입니다. 정보 클래스는 이 매개 변수의 내용을 결정합니다.

[in] InformationLength

TraceInformation 버퍼에 있는 데이터의 크기(바이트)입니다.

반환 값

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

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

• ERROR_BAD_LENGTH

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

• ERROR_INVALID_PARAMETER

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

• ERROR_NOT_SUPPORTED

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

• 기타

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

설명

StartTrace를 호출한 후 이 함수를 호출합니다.

InformationClass 매개 변수가 TraceStackTracingInfo로 설정된 경우 이 함수를 호출하면 지정된 커널 이벤트를 스택 추적할 수 있습니다. 이 함수에 대한 후속 호출은 스택 추적이 사용하도록 설정된 이전 커널 이벤트 목록을 덮어씁니다. 스택 추적을 사용하지 않도록 설정하려면 InformationClass 가 TraceStackTracingInfo 로 설정되고 InformationLength 가 0으로 설정된 상태에서 이 함수를 호출합니다.

이벤트의 확장된 데이터 섹션에는 호출 스택이 포함됩니다. StackWalk_Event MOF 클래스는 확장 데이터의 레이아웃을 정의합니다.

일반적으로 64비트 컴퓨터에서는 페이지 오류가 허용되지 않는 경우 특정 컨텍스트에서 커널 스택을 캡처할 수 없습니다. x64에서 커널 스택을 탐색할 수 있도록 하려면 메모리 관리 레지스트리 값을 1로 설정합니다 DisablePagingExecutive . DisablePagingExecutive 레지스트리 값은 레지스트리 키 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management아래에 있습니다. 시스템의 메모리 사용량이 증가하므로 임시 진단 목적으로만 수행해야 합니다.

요구 사항

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

추가 정보

TRACE_QUERY_INFO_CLASS

TraceQueryInformation