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:

1. Chame a função SetLastError para definir o último erro como ERROR_SUCCESS.
2. Chame a função GetTraceEnableLevel para recuperar o nível de habilitação.
3. Se o valor de nível de habilitação for 0, chame a função GetLastError para recuperar o último erro conhecido.
4. 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

Confira também

GetTraceEnableFlags

GetTraceLoggerHandle