Macro TraceLoggingLevel (traceloggingprovider.h)

Article
03/06/2024

Macro wrapper TraceLogging qui définit le niveau de l’événement.

Syntaxe

void TraceLoggingLevel(
  [in]  eventLevel
);

Paramètres

[in] eventLevel

Nombre 8 bits utilisé pour décrire la gravité ou l’importance d’un événement. Cette valeur doit être une constante de compilation comprise entre 0 et 255. Si aucun argument TraceLoggingLevel n’est fourni à un appel TraceLoggingWrite , le niveau de l’événement est défini par défaut sur 5 (WINEVENT_LEVEL_VERBOSE).

Important

ProviderId, Level et Keyword sont les principaux moyens de filtrage des événements. D’autres types de filtrage sont possibles, mais ont une surcharge beaucoup plus élevée. Affectez toujours un niveau significatif autre que zéro et mot clé à chaque événement.

Pour plus d’informations sur le niveau d’événement , consultez EVENT_DESCRIPTOR .

Valeur de retour

None

Remarques

TraceLoggingLevel(eventLevel) peut être utilisé comme paramètre pour appeler une macro TraceLoggingWrite pour définir le niveau de l’événement. Le niveau d’événement est un moyen principal de filtrer les événements. Affectez toujours un niveau significatif (autre que zéro) à chaque événement.

Si aucune macro TraceLoggingLevel n’est fournie à un appel TraceLoggingWrite , le niveau par défaut de l’événement est 5 (WINEVENT_LEVEL_VERBOSE). Si plusieurs macros TraceLoggingLevel sont fournies, la dernière valeur est utilisée.

Les valeurs de niveau 0 à 5 sont définies par Microsoft (voir evntrace.h et winmeta.h). Les valeurs de niveau 6 à 15 sont réservées pour une définition ultérieure par Microsoft. Les valeurs de niveau 16 à 255 peuvent être définies par le fournisseur d’événements.

Valeur	Sémantique
LOG_ALWAYS (0)	L’événement contourne le filtrage d’événements basé sur le niveau. Les événements ne doivent pas utiliser ce niveau.
CRITIQUE (1)	Erreur critique
ERREUR (2)	Erreur
AVERTISSEMENT (3)	Avertissement
INFO (4)	Informationnel
VERBOSE (5)	Commentaires

Les sessions de collection d’événements peuvent définir un filtre de niveau, ce qui signifie que la session n’accepte que les événements où eventDescriptor.Level <= session.LevelFilter. Notez que les événements avec un niveau de 0 ignorent le filtrage basé sur le niveau.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	traceloggingprovider.h

Voir aussi

EVENT_DESCRIPTOR

TraceLoggingWrite

Macros du wrapper TraceLogging

Partager via