IDebugFailureAnalysis2::SetString 方法 (extsfns.h)

SetString 方法在 DebugFailureAnalysis 对象中搜索具有指定标记的第一个 FA 条目。 如果它发现具有指定标记的 FA 条目,则会将 (覆盖) FA 条目的数据块设置为指定的字符串值。 如果此方法找不到具有指定标记的 FA 条目 ,则会使用该标记创建一个新的 FA 条目,并将新 FA 条目的数据块设置为指定的字符串值。

语法

PFA_ENTRY SetString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

参数

Tag

FA_TAG枚举中的值。

[in] Str

指向要写入新 FA 条目或现有 FA 条目的数据块的以 null 结尾的 ANSI 字符串的指针。

返回值

如果此方法成功,它将返回指向新FA_ENTRY或现有 FA_ENTRY 结构的指针。 否则,它将返回 NULL

注解

如果此方法找到具有指定标记的 FA 条目 ,它会检查与该标记关联的数据类型是 DEBUG_FA_ENTRY_ANSI_STRING 还是 DEBUG_FA_ENTRY_EXTENSION_CMD。 如果与标记关联的数据类型不是这两种类型之一,则此方法返回 NULL ,并且不会覆盖条目的数据块。

如果此方法找不到具有指定标记的 FA 条目 ,则会创建一个具有该标记的新 FA 条目,并将标记与 数据类型DEBUG_FA_ENTRY_ANSI_STRING关联。

要求

要求
目标平台 桌面
标头 extsfns.h

另请参阅

AddString

IDebugFailureAnalysis2

编写分析扩展插件以扩展 !analyze

_EFN_Analyze