OpenTraceFromRealTimeLogger-Funktion (evntrace.h)

Artikel
07/19/2024

Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die an eine aktive ECHTZEIT-ETW-Sitzung angefügt ist.

Syntax

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

Parameter

LoggerName

Name der Echtzeitereignisablaufverfolgungssitzung oder NULL-, wenn Daten aus einer Protokolldatei verarbeitet werden. Geben Sie einen Wert für dieses Element an, wenn Sie OpenTraceFromRealTimeLogger- aufrufen, um Daten aus einer Echtzeitsitzung zu nutzen.

Wenn OpenTraceFromRealTimeLogger-aufgerufen wird, wenn LogFileHead er nichtNULL- ist, muss LoggerName-NULL-sein.

Sie können Ereignisse nur in Echtzeit verwenden, wenn der Ablaufverfolgungscontroller das LogFileMode- Mitglied von EVENT_TRACE_PROPERTIES so festgelegt hat, dass das EVENT_TRACE_REAL_TIME_MODE Flag eingeschlossen wird.

Nur Benutzer mit Administratorrechten, Benutzer in der Gruppe "Performance Log Users" und Anwendungen, die als LocalSystem, LocalService, NetworkService ausgeführt werden, können Ereignisse in Echtzeit nutzen. Um einem eingeschränkten Benutzer die Möglichkeit zu gewähren, Ereignisse in Echtzeit zu nutzen, fügen Sie sie der Gruppe "Performance Log Users" hinzu, oder rufen Sie EventAccessControlauf.

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, empfängt dies Puffer aus der ETW-Sitzung, während sie geleert werden, und beginnen sofort mit der Verarbeitung und dem Aufrufen der rückrufen, die in der Optionsangegeben sind.

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

Freigeben über