TraceLoggingLevel-Makro (traceloggingprovider.h)
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 |