OpenTraceFromFile function (evntrace.h)

Creates a trace processing session to process a Tracelog .etl file.

Syntax

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromFile(
  PCWSTR                       LogFileName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Parameters

LogFileName

The path of the Tracelog .etl file to process.

Options

Configuration options for this processing session. See ETW_OPEN_TRACE_OPTIONS for more details.

LogFileHeader

Header information for the log file. See TRACE_LOGFILE_HEADER for more details.

Return value

A TRACEHANDLE that is used to identify this processing session. Typically passed to ProcessTrace to begin processing and to CloseTrace to end processing.

Remarks

Once ProcessTrace is called on the returned TRACEHANDLE, this will immediately begin processing the file and calling the callbacks specified in Options.

Requirements

Requirement Value
Minimum supported client Windows 11 2022 Update
Minimum supported server Windows Server 2022
Target Platform Windows
Header evntrace.h
Library Advapi32.dll
DLL Sechost.dll on Windows 8.1 and Windows Server 2012 R2; Advapi32.dll on Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista and Windows XP