TraceLoggingLevel-Makro (traceloggingprovider.h)

Artikel
08/26/2023

TraceLogging-Wrappermakro , das die Ebene für das Ereignis festlegt.

Syntax

void TraceLoggingLevel(
  [in]  eventLevel
);

Parameter

[in] eventLevel

Eine 8-Bit-Zahl, die verwendet wird, um den Schweregrad oder die Wichtigkeit eines Ereignisses zu beschreiben. Dieser Wert muss eine Kompilierzeitkonstante im Bereich von 0 bis 255 sein. Wenn für einen TraceLoggingWrite-Aufruf keine TraceLoggingLevel-Argumente bereitgestellt werden, wird die Ereignisebene standardmäßig auf 5 (WINEVENT_LEVEL_VERBOSE) festgelegt.

Wichtig

ProviderId, Level und Keyword sind die wichtigsten Mittel zum Filtern von Ereignissen. Andere Filterarten sind möglich, haben aber einen viel höheren Aufwand. Weisen Sie jedem Ereignis immer eine sinnvolle Nicht-Null-Ebene zu und Schlüsselwort (keyword).

Weitere Informationen zur Ereignisebene finden Sie unter EVENT_DESCRIPTOR .

Rückgabewert

Keine

Bemerkungen

TraceLoggingLevel(eventLevel) kann als Parameter für einen Aufruf eines TraceLoggingWrite-Makros verwendet werden, um die Ereignisebene festzulegen. Die Ereignisebene ist ein primäres Mittel zum Filtern von Ereignissen. Weisen Sie jedem Ereignis immer eine sinnvolle Ebene (ungleich 0) zu.

Wenn keine TraceLoggingLevel-Makros für einen TraceLoggingWrite-Aufruf bereitgestellt werden, ist die Standardebene des Ereignisses 5 (WINEVENT_LEVEL_VERBOSE). Wenn mehrere TraceLoggingLevel-Makros bereitgestellt werden, wird der letzte Wert verwendet.

Die Werte der Ebenen 0 bis 5 werden von Microsoft definiert (siehe evntrace.h und winmeta.h). Die Werte der Ebenen 6 bis 15 sind für die zukünftige Definition durch Microsoft reserviert. Die Ebenenwerte 16 bis 255 können vom Ereignisanbieter definiert werden.

Wert	Semantik
LOG_ALWAYS (0)	Ereignis umgeht die ebenenbasierte Ereignisfilterung. Ereignisse sollten diese Ebene nicht verwenden.
KRITISCH (1)	Schwerwiegender Fehler
FEHLER (2)	Fehler
WARNUNG (3)	Warnung
INFO (4)	Informational
AUSFÜHRLICH (5)	Ausführlich

Ereignissammlungssitzungen können einen Ebenenfilter festlegen, was bedeutet, dass die Sitzung nur Ereignisse akzeptiert, bei denen eventDescriptor.Level <= session.LevelFilter. Beachten Sie, dass Ereignisse mit der Ebene 0 die ebenenbasierte Filterung umgehen.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	traceloggingprovider.h

Weitere Informationen

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging-Wrappermakros

Share via