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] TRACEHANDLE 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

Requisito	Valor
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

Confira também

GetTraceEnableLevel

GetTraceLoggerHandle