IDebugFailureAnalysis：：GetString 方法 (extsfns.h)

项目
02/29/2024

GetString 方法在 DebugFailureAnalysis 对象中搜索具有指定标记的第一个 FA 条目。如果它找到具有指定标记的 FA 条目，它将从该条目的数据块获取 ANSI 字符串值。

语法

PFA_ENTRY GetString(
  [in]  FA_TAG Tag,
  [out] PSTR   Str,
  [in]  ULONG  MaxSize
);

参数

[in] Tag

FA_TAG枚举中的值。

[out] Str

指向从条目的数据块接收字符串值的缓冲区的指针。

[in] MaxSize

Str 指向的缓冲区的大小（以字节为单位）。

返回值

如果此方法找到具有指定标记的 FA 条目，并且成功获取数据块，则返回指向 FA_ENTRY 结构的指针。否则，它将返回 NULL。

注解

此方法将以 null 结尾的字符串从条目的数据块复制到 Str 指向的缓冲区。此方法最多复制 MaxSize 字符，包括 NULL 终止符。

DebugFailureAnalysis 对象中已使用的每个标记都与 FA_ENTRY_TYPE 枚举中的一种数据类型相关联。若要确定与标记关联的数据类型，请调用 IDebugFAEntryTags 接口的 GetType 方法。若要获取指向 IDebugFAEntryTags 接口的指针，请调用 IDebugFailureAnalysis2 接口的 GetDebugFATagControl 方法。

此方法的适当用法是从数据类型为 DEBUG_FA_ENTRY_ANSI_STRING 的 FA 条目获取数据块。