Edit

OpenTraceFromFile function (evntrace.h)

  • Article

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

Syntax

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE 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 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header evntrace.h
Library Sechost.lib on Windows 8.1 and Windows Server 2012 R2; Advapi32.lib on Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista and Windows XP
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