Funzione OpenTraceFromRealTimeLogger (evntrace.h)

Articolo
07/19/2024

Crea una sessione di elaborazione della traccia collegata a una sessione ETW attiva in tempo reale.

Sintassi

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

Parametri

LoggerName

Nome della sessione di traccia eventi in tempo reale o NULL se si elaborano dati da un file di log. Specificare un valore per questo membro se si chiama OpenTraceFromRealTimeLogger per utilizzare i dati da una sessione in tempo reale.

Quando si chiama OpenTraceFromRealTimeLogger, se LogFileHeader non ènull, LoggerName deve essere NULL.

È possibile utilizzare gli eventi in tempo reale solo se il controller di traccia ha impostato il membro LogFileMode di EVENT_TRACE_PROPERTIES per includere il flag di EVENT_TRACE_REAL_TIME_MODE.

Solo gli utenti con privilegi amministrativi, gli utenti nel gruppo Performance Log Users e le applicazioni in esecuzione come LocalSystem, LocalService, NetworkService possono utilizzare eventi in tempo reale. Per concedere a un utente limitato la possibilità di utilizzare gli eventi in tempo reale, aggiungerli al gruppo Performance Log Users o chiamare EventAccessControl.

Options

Opzioni di configurazione per questa sessione di elaborazione. Per altri dettagli, vedere ETW_OPEN_TRACE_OPTIONS.

LogFileHeader

Informazioni sull'intestazione per il file di log. Per altri dettagli, vedere TRACE_LOGFILE_HEADER.

Valore restituito

TRACEHANDLE utilizzato per identificare questa sessione di elaborazione. In genere passato a ProcessTrace per iniziare l'elaborazione e per CloseTrace alla fine dell'elaborazione.

Osservazioni

Dopo aver chiamato ProcessTrace sul TRACEHANDLE restituito, riceverà i buffer dalla sessione ETW mentre vengono scaricati e iniziano immediatamente a elaborarli e chiamando i callback specificati nella Options.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 11 2022 Update
server minimo supportato	Windows Server 2022
piattaforma di destinazione	Finestre
intestazione	evntrace.h
libreria	Advapi32.dll
dll	Sechost.dll in Windows 8.1 e Windows Server 2012 R2; Advapi32.dll in Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP

Condividi tramite