Função OpenTraceFromRealTimeLogger (evntrace.h)

Cria uma sessão de processamento de rastreamento anexada a uma sessão ETW ativa em tempo real.

Sintaxe

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

Parâmetros

LoggerName

Nome da sessão de rastreamento de eventos em tempo real ou NULL se estiver processando dados de um arquivo de log. Especifique um valor para esse membro se você estiver chamando OpenTraceFromRealTimeLogger para consumir dados de uma sessão em tempo real.

Ao chamar OpenTraceFromRealTimeLogger, se LogFileHeader não for NULL , LoggerName deverá ser NULL.

Você só poderá consumir eventos em tempo real se o controlador de rastreamento tiver definido o membro LogFileMode de EVENT_TRACE_PROPERTIES para incluir o sinalizador EVENT_TRACE_REAL_TIME_MODE .

Somente usuários com privilégios administrativos, usuários no grupo Usuários do Log de Desempenho e aplicativos em execução como LocalSystem, LocalService, NetworkService podem consumir eventos em tempo real. Para conceder a um usuário restrito a capacidade de consumir eventos em tempo real, adicione-os ao grupo Usuários do Log de Desempenho ou chame EventAccessControl.

Options

Opções de configuração para esta sessão de processamento. Consulte ETW_OPEN_TRACE_OPTIONS para obter mais detalhes.

LogFileHeader

Informações de cabeçalho para o arquivo de log. Consulte TRACE_LOGFILE_HEADER para obter mais detalhes.

Retornar valor

Um TRACEHANDLE que é usado para identificar essa sessão de processamento. Normalmente passado para ProcessTrace para começar o processamento e para CloseTrace para encerrar o processamento.

Comentários

Depois que ProcessTrace for chamado no TRACEHANDLE retornado, ele receberá buffers da sessão ETW à medida que forem liberados e começará imediatamente a processá-los e chamar os retornos de chamada especificados nas Opções.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	evntrace.h
Biblioteca	Sechost.lib em Windows 8.1 e Windows Server 2012 R2; Advapi32.lib em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP
DLL	Sechost.dll em Windows 8.1 e Windows Server 2012 R2; Advapi32.dll em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP