IDebugFailureAnalysis：：GetUlong64 方法（extsfns.h）

项目
02/06/2025

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

语法

PFA_ENTRY GetUlong64(
        FA_TAG   Tag,
  [out] PULONG64 Value
);

参数

Tag

FA_TAG 枚举中的值。

[out] Value

指向从条目的数据块接收值的 ULONG64 的指针。

返回值

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

言论

如果此方法找到具有指定标记的 FA 条目，则会检查 FA_ENTRY 结构的 DataSize 成员是否等于 ULONG64的大小。如果 DataSize 不等于 ULONG64的大小，此方法将返回 NULL，并且不会获取数据块。

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

此方法的适当用法是从具有数据类型 DEBUG_FA_ENTRY_ULONG64 或 DEBUG_FA_ENTRY_INSTRUCTION_OFFSET 或 DEBUG_FA_ENTRY_POINTER FA 条目获取数据块。