traceLoggingLevel 宏 (traceloggingprovider.h)

  • 项目

TraceLogging 包装宏 ，用于设置事件的级别。

语法

void TraceLoggingLevel(
  [in]  eventLevel
);

参数

[in] eventLevel

用于描述事件的严重性或重要性的 8 位数字。 此值必须是 0 到 255 范围内的编译时常量。 如果未向 TraceLoggingWrite 调用提供 TraceLoggingLevel 参数，则事件的级别将默认为 5 (WINEVENT_LEVEL_VERBOSE) 。

重要

ProviderId、Level 和 Keyword 是筛选事件的主要方法。 其他类型的筛选是可能的，但开销要高得多。 始终为每个事件分配有意义的非零级别和关键字 (keyword) 。

有关事件级别的详细信息，请参阅 EVENT_DESCRIPTOR 。

返回值

无

备注

TraceLoggingLevel(eventLevel) 可用作 TraceLoggingWrite 宏调用的参数，以设置事件的级别。 事件级别是筛选事件的主要方法。 始终为每个事件分配有意义的 (非零) 级别。

如果未向 TraceLoggingWrite 调用提供 TraceLoggingLevel 宏，则事件的默认级别为 5 (WINEVENT_LEVEL_VERBOSE) 。 如果提供了多个 TraceLoggingLevel 宏，则使用最后一个值。

级别值 0 到 5 由 Microsoft (查看 evntrace.h 和 winmeta.h) 定义。 级别值 6 到 15 由 Microsoft 保留，供将来定义。 级别值 16 到 255 可由事件提供程序定义。

值 语义
LOG_ALWAYS (0) 事件绕过基于级别的事件筛选。 事件不应使用此级别。
关键 (1) 严重错误
错误 (2) 错误
警告 (3) 警告
INFO (4) 信息
详细 (5) 详细

事件集合会话可以设置级别筛选器，这意味着会话将仅接受其中 eventDescriptor.Level <= session.LevelFilter的事件。 请注意，级别为 0 的事件将绕过基于级别的筛选。

示例

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

要求

要求 值
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 traceloggingprovider.h

另请参阅

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging 包装宏