IDebugFailureAnalysis2::AddString 方法 (extsfns.h)
AddString 方法向 DebugFailureAnalysis 对象添加新的 FA 条目,并将 FA 条目的数据块设置为指定的字符串。
语法
PFA_ENTRY AddString(
FA_TAG Tag,
[in] PCSTR Str
);
参数
Tag
FA_TAG枚举中的值。 必须 DEBUG_FA_ENTRY_ANSI_STRING与此标记关联的数据类型。
[in] Str
指向要写入新 FA 条目的数据块的以 null 结尾的 ANSI 字符串的指针。
返回值
如果此方法成功,则返回 返回指向新 FA_ENTRY 结构的指针。 如果此方法失败,则返回 NULL。
注解
此方法将新 FA_ENTRY 结构的 DataSize 成员设置为字符串(包括 NULL 终止符)的长度(以字节为单位)。
每个标记都与 FA_ENTRY_TYPE 枚举中的一种数据类型相关联。 若要确定与标记关联的数据类型,请调用 IDebugFAEntryTags 接口的 GetType 方法。
若要获取指向 IDebugFAEntryTags 接口的指针,请调用 IDebugFailureAnalysis2 接口的 GetDebugFATagControl 方法。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | extsfns.h |