IDebugFailureAnalysis：：GetUlong 方法（extsfns.h）

项目
02/06/2025

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

语法

PFA_ENTRY GetUlong(
  [in]  FA_TAG Tag,
  [out] PULONG Value
);

参数

[in] Tag

FA_TAG 枚举中的值。

[out] Value

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

返回值

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

言论

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

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

此方法的适当用法是从具有数据类型 DEBUG_FA_ENTRY_ANSI_STRINGFA 条目获取数据块。