IDebugFailureAnalysis：：GetUlong64 方法 (extsfns.h)

项目
02/29/2024

GetUlong64 方法在 DebugFailureAnalysis 对象中搜索具有指定标记的第一个 FA 条目。如果找到具有指定标记的 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 条目获取数据块。