Função GetTraceEnableFlags (evntrace.h)

Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função GetTraceEnableFlags para recuperar os sinalizadores de habilitação especificados pelo controlador de rastreamento para indicar qual categoria de eventos rastrear.

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

Sintaxe

ULONG WMIAPI GetTraceEnableFlags(
  [in] TRACELOGGER_HANDLE TraceHandle
);

Parâmetros

[in] TraceHandle

Manipule para uma sessão de rastreamento de eventos, obtida chamando a função GetTraceLoggerHandle .

Retornar valor

Retorna o valor especificado pelo controlador no parâmetro EnableFlag 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 GetTraceEnableFlags para recuperar os sinalizadores de habilitação.
3. Se o valor de habilitar sinalizadores 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á os sinalizadores de habilitação como 0; caso contrário, a função GetTraceEnableFlags falhou com o último erro conhecido.

Comentários

Os provedores podem usar esse valor para controlar quais eventos ele gera. Por exemplo, um provedor pode agrupar eventos em categorias lógicas de eventos e usar esse valor para habilitar ou desabilitar sua geração.

Exemplos

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

Requisitos

Confira também

GetTraceEnableLevel

GetTraceLoggerHandle