TraceLoggingBinary 宏 (traceloggingprovider.h)

  • 项目

TraceLogging 包装器宏 ，用于向事件添加具有二进制数据的字段。

语法

void TraceLoggingBinary(
  [in]            pValue,
  [in]            cbValue,
  [in, optional]  __VA_ARGS__
);

参数

[in] pValue

指向要包含在事件中的数据的指针。

[in] cbValue

要包含在事件中的数据的大小（以字节为单位）。

[in, optional] __VA_ARGS__

字段定义的可选 名称、 说明和 标记 参数。

TraceLoggingBinary 可以使用 2、3、4 或 5 个参数指定。 如果未指定可选参数，将使用默认值。 例如，TraceLoggingBinary(&x.data, sizeof(x.data)) 等效于 TraceLoggingBinary(&x.data, sizeof(x.data), "&x.data", "", 0)。

  • [in, optional] name

    要用于事件字段的名称。 如果提供名称参数，则名称参数必须是字符串文本 (而不是) 变量，并且不得包含任何“\0”字符。 如果未提供，事件字段名称将基于 pValue。

  • [in, optional] description

    事件字段值的说明。 如果提供说明参数，则说明参数必须是字符串文本，并且将包含在 PDB 中。

  • [in, optional] tags

    编译时常量整数值。 该值的低 28 位将包含在字段的元数据中。 此值的语义由事件使用者定义。 在事件处理期间，可以从 “EVENT_PROPERTY_INFO 标记”字段检索此值。

返回值

无

备注

TraceLoggingBinary(pValue, cbValue, ...) 可用作 TraceLoggingWrite 宏调用的参数。 每个 TraceLoggingBinary 参数都会向事件添加一个字段。

要求

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

另请参阅

TraceLoggingWrite

TraceLogging 包装宏