Função GetTraceLoggerHandle (evntrace.h)

Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função GetTraceLoggerHandle para recuperar o identificador da sessão de rastreamento de eventos na qual deve gravar eventos.

Os provedores chamam essa função de sua função ControlCallback .

Sintaxe

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

Parâmetros

[in] Buffer

Ponteiro para uma estrutura de WNODE_HEADER . O ETW passa essa estrutura para a função ControlCallback do provedor no parâmetro Buffer .

O membro HistoricContext do WNODE_HEADER contém o identificador da sessão.

Valor retornado

Se a função for bem-sucedida, ela retornará o identificador de sessão de rastreamento de eventos.

Se a função falhar, ela retornará INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame a função GetLastError.

Comentários

Use o identificador ao chamar as funções GetTraceEnableFlags e GetTraceEnableLevel para recuperar os sinalizadores de habilitação e os valores de nível passados para a função EnableTrace .

Exemplos

Para obter um exemplo que usa GetTraceLoggerHandle, consulte Recuperando dados de evento usando MOF.

Requisitos

Confira também

GetTraceEnableFlags

GetTraceEnableLevel