Compartilhar via


Macro TraceLoggingLevel (traceloggingprovider.h)

Macro wrapper TraceLogging que define o nível do evento.

Sintaxe

void TraceLoggingLevel(
  [in]  eventLevel
);

Parâmetros

[in] eventLevel

Um número de 8 bits usado para descrever a gravidade ou a importância de um evento. Esse valor deve ser uma constante de tempo de compilação no intervalo de 0 a 255. Se nenhum argumento TraceLoggingLevel for fornecido a uma chamada TraceLoggingWrite , o nível do evento será padronizado como 5 (WINEVENT_LEVEL_VERBOSE).

Importante

ProviderId, Level e Keyword são os principais meios para filtrar eventos. Outros tipos de filtragem são possíveis, mas têm uma sobrecarga muito maior. Sempre atribua um nível diferente de zero significativo e palavra-chave a cada evento.

Consulte EVENT_DESCRIPTOR para obter detalhes sobre o nível de evento.

Retornar valor

Nenhum

Comentários

TraceLoggingLevel(eventLevel) pode ser usado como um parâmetro para uma invocação de uma macro TraceLoggingWrite para definir o nível do evento. O nível de evento é um meio principal para filtrar eventos. Sempre atribua um nível significativo (diferente de zero) a cada evento.

Se nenhuma macro TraceLoggingLevel for fornecida a uma chamada TraceLoggingWrite , o nível padrão do evento será 5 (WINEVENT_LEVEL_VERBOSE). Se várias macros TraceLoggingLevel forem fornecidas, o último valor será usado.

Os valores de nível 0 a 5 são definidos pela Microsoft (consulte evntrace.h e winmeta.h). Os valores de nível de 6 a 15 são reservados para definição futura pela Microsoft. Os valores de nível de 16 a 255 podem ser definidos pelo provedor de eventos.

Valor Semântica
LOG_ALWAYS (0) O evento ignora a filtragem de eventos baseada em nível. Os eventos não devem usar esse nível.
CRÍTICO (1) Erro crítico
ERRO (2) Erro
AVISO (3) Aviso
INFORMAÇÕES (4) Informativo
VERBOSE (5) Detalhado

As sessões de coleção de eventos podem definir um filtro de nível, o que significa que a sessão só aceitará eventos em eventDescriptor.Level <= session.LevelFilterque . Observe que eventos com um nível de 0 ignorarão a filtragem baseada em nível.

Exemplos

TraceLoggingWrite(
    g_hMyProvider,
    "MyWarningEventName",
    TraceLoggingLevel(WINEVENT_LEVEL_WARNING), // Levels defined in <winmeta.h>
    TraceLoggingKeyword(MyNetworkingKeyword), // Provider-defined keyword
    TraceLoggingHResult(errorCode, "Error"));

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho traceloggingprovider.h

Confira também

EVENT_DESCRIPTOR

TraceLoggingWrite

Macros de wrapper traceLogging