TraceSetInformation 함수(evntrace.h)
TraceSetInformation 함수는 이벤트 추적 세션 설정을 구성합니다.
구문
ULONG WMIAPI TraceSetInformation(
CONTROLTRACE_ID TraceId,
[in] TRACE_INFO_CLASS InformationClass,
[in] PVOID TraceInformation,
[in] ULONG InformationLength
);
매개 변수
TraceId
[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.1 및 Windows Server 2012 R2의 Sechost.dll. Windows 8, Windows Server 2012, Windows 7 및 Windows Server 2008 R2의 Advapi32.dll |