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 包装宏