IDebugFailureAnalysis2：：SetString 方法 （extsfns.h）
SetString 方法搜索具有指定标记的第一个 FA 条目 的 DebugFailureAnalysis 对象。 如果找到具有指定标记的 FA 条目，则会将 FA 条目的数据块设置为指定的字符串值（覆盖）。 如果此方法找不到具有指定标记的 FA 条目，则会使用该标记创建一个新的 FA 条目，并将新 FA 条目的数据块设置为指定的字符串值。
语法
PFA_ENTRY SetString(
FA_TAG Tag,
[in] PCSTR Str
);
参数
Tag
FA_TAG 枚举中的值。
[in] Str
指向要写入新项或现有 FA 条目的数据块的空终止 ANSI 字符串的指针。
返回值
如果此方法成功，它将返回指向新结构或现有 FA_ENTRY 结构的指针。 否则，它将返回 NULL 。
言论
如果此方法查找具有指定标记 FA 条目，则它会检查与该标记关联的数据类型是 DEBUG_FA_ENTRY_ANSI_STRING 还是 DEBUG_FA_ENTRY_EXTENSION_CMD。 如果与标记关联的数据类型不是这两种类型之一，此方法将返回 NULL，并且不会覆盖条目的数据块。
如果此方法找不到具有指定标记的 FA 条目，则会使用该标记创建新的 FA 条目，并将标记与数据类型关联 DEBUG_FA_ENTRY_ANSI_STRING。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | extsfns.h |