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 |