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 条目的数据块的空终止 ANSI 字符串的指针。

返回值

如果此方法成功,它将返回指向新 FA_ENTRY 结构的指针。 如果此方法失败,则返回 NULL

注解

此方法将新FA_ENTRY结构的 DataSize 成员设置为字符串的长度(以字节为单位)包括 NULL 终止符。

每个标记都与 FA_ENTRY_TYPE 枚举中的其中一种数据类型相关联。 若要确定与标记关联的数据类型,请调用 IDebugFAEntryTags 接口的 GetType 方法。

若要获取指向 IDebugFAEntryTags 接口的指针,请调用 IDebugFailureAnalysis2 接口的 GetDebugFATagControl 方法。

要求

   
目标平台 桌面
Header extsfns.h

另请参阅

IDebugFAEntryTags

IDebugFailureAnalysis2

SetString

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

_EFN_Analyze