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 |