OpenTraceFromRealTimeLogger-Funktion (evntrace.h)

  • Artikel

Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die einer aktiven ETW-Sitzung in Echtzeit angefügt ist.

Syntax

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE 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 LogFileHeaderbeim Aufrufen von OpenTraceFromRealTimeLogger nicht NULL ist, muss LoggerNameNULL sein.

Sie können Ereignisse nur in Echtzeit nutzen, wenn der Ablaufverfolgungscontroller das LogFileMode-Element von EVENT_TRACE_PROPERTIES so festgelegt hat, dass er das EVENT_TRACE_REAL_TIME_MODE-Flag enthält.

Nur Benutzer mit Administratorrechten, Benutzer in der Gruppe Leistungsprotokollbenutzer und Anwendungen, die als LocalSystem, LocalService und NetworkService ausgeführt werden, können Ereignisse in Echtzeit nutzen. Um einem eingeschränkten Benutzer die Möglichkeit zu geben, Ereignisse in Echtzeit zu nutzen, fügen Sie sie der Gruppe Leistungsprotokollbenutzer hinzu, oder rufen Sie EventAccessControl auf.

Options

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

LogFileHeader

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

Rückgabewert

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

Hinweise

Sobald ProcessTrace für das zurückgegebeneTRACEHANDLE aufgerufen wird, empfängt dieser Puffer aus der ETW-Sitzung, während sie geleert werden, und beginnt sofort mit der Verarbeitung und dem Aufrufen der in den Optionen angegebenen Rückrufe.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile evntrace.h
Bibliothek Sechost.lib auf Windows 8.1 und Windows Server 2012 R2; Advapi32.lib unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP
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