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
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 | Advapi32.lib |
DLL | Advapi32.dll |