OpenTraceFromRealTimeLogger 함수(evntrace.h)

활성 실시간 ETW 세션에 연결된 추적 처리 세션을 만듭니다.

구문

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

매개 변수

LoggerName

실시간 이벤트 추적 세션의 이름 또는 로그 파일에서 데이터를 처리하는 경우 NULL 입니다. OpenTraceFromRealTimeLogger를 호출하여 실시간 세션의 데이터를 사용하는 경우 이 멤버의 값을 지정합니다.

OpenTraceFromRealTimeLogger를 호출할 때 LogFileHeader가 NULL이 아닌 경우 LoggerName은 NULL이어야 합니다.

추적 컨트롤러가 EVENT_TRACE_REAL_TIME_MODE 플래그를 포함하도록 EVENT_TRACE_PROPERTIESLogFileMode 멤버를 설정한 경우에만 이벤트를 실시간으로 사용할 수 있습니다.

관리자 권한이 있는 사용자, 성능 로그 사용자 그룹의 사용자 및 LocalSystem, LocalService, NetworkService로 실행되는 애플리케이션만 실시간으로 이벤트를 사용할 수 있습니다. 제한된 사용자에게 이벤트를 실시간으로 사용할 수 있는 기능을 부여하려면 이벤트를 성능 로그 사용자 그룹에 추가하거나 EventAccessControl을 호출합니다.

Options

이 처리 세션에 대한 구성 옵션입니다. 자세한 내용은 ETW_OPEN_TRACE_OPTIONS 참조하세요.

LogFileHeader

로그 파일에 대한 헤더 정보입니다. 자세한 내용은 TRACE_LOGFILE_HEADER 참조하세요.

반환 값

이 처리 세션을 식별하는 데 사용되는 TRACEHANDLE입니다. 일반적으로 처리를 시작하고 처리를 종료하기 위해 CloseTrace에 ProcessTrace에 전달됩니다.

설명

반환된 TRACEHANDLE에서 ProcessTrace가 호출되면 ETW 세션이 플러시될 때 버퍼를 수신하고 즉시 처리를 시작하고 옵션에 지정된 콜백을 호출합니다.

요구 사항

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