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