Função GetTraceEnableLevel (evntrace.h)
Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função GetTraceEnableLevel para recuperar o nível de habilitação especificado pelo controlador de rastreamento para indicar qual nível de eventos rastrear.
Os provedores chamam essa função de sua função ControlCallback .
Sintaxe
UCHAR WMIAPI GetTraceEnableLevel(
[in] TRACEHANDLE TraceHandle
);
Parâmetros
[in] TraceHandle
Manipule para uma sessão de rastreamento de eventos, obtida chamando a função GetTraceLoggerHandle .
Valor retornado
Retorna o valor especificado pelo controlador no parâmetro EnableLevel ao chamar a função EnableTrace .
Para determinar se a função falhou ou se o controlador definiu os sinalizadores de habilitação como 0, siga estas etapas:
- Chame a função SetLastError para definir o último erro como ERROR_SUCCESS.
- Chame a função GetTraceEnableLevel para recuperar o nível de habilitação.
- Se o valor de nível de habilitação for 0, chame a função GetLastError para recuperar o último erro conhecido.
- Se o último erro conhecido for ERROR_SUCCESS, o controlador definirá o nível de habilitação como 0; caso contrário, a função GetTraceEnableLevel falhou com o último erro conhecido.
Comentários
Os provedores usam esse valor para controlar a gravidade dos eventos gerados por ele. Por exemplo, os provedores podem usar esse valor para determinar se ele deve gerar eventos informativos, de aviso ou de erro.
Exemplos
Para obter um exemplo que usa GetTraceEnableLevel, 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 |