Freigeben über


OpenTraceFromFile-Funktion (evntrace.h)

Erstellt eine Ablaufverfolgungsverarbeitungssitzung zum Verarbeiten einer Tracelog -ETL-Datei.

Syntax

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

Parameter

LogFileName

Der Pfad der zu verarbeitenden Tracelog-ETL-Datei.

Options

Konfigurationsoptionen für diese Verarbeitungssitzung. Weitere Informationen finden Sie unter ETW_OPEN_TRACE_OPTIONS.

LogFileHeader

Kopfzeileninformationen für die Protokolldatei. Weitere Informationen finden Sie unter TRACE_LOGFILE_HEADER.

Rückgabewert

Eine TRACEHANDLE, die verwendet wird, um diese Verarbeitungssitzung zu identifizieren. Wird in der Regel an ProcessTrace- übergeben, um mit der Verarbeitung zu beginnen und CloseTrace- an die Verarbeitung zu beenden.

Bemerkungen

Sobald ProcessTrace für die zurückgegebene TRACEHANDLE-aufgerufen wird, beginnt dies sofort mit der Verarbeitung der Datei und dem Aufrufen der in Optionsangegebenen Rückrufe.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 11 2022 Update
mindestens unterstützte Server- Windows Server 2022
Zielplattform- Fenster
Header- evntrace.h
Library Advapi32.dll
DLL- Sechost.dll unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP