IDebugFailureAnalysis2：：SetUlong64 方法 (extsfns.h)

项目
02/29/2024

SetUlong64 方法在 DebugFailureAnalysis 对象中搜索具有指定标记的第一个 FA 条目。如果找到具有指定标记的 FA 条目，则会将 (覆盖) FA 条目的数据块设置为指定的 ULONG64 值。如果此方法找不到具有指定标记的 FA 条目，它将创建一个具有该标记的新 FA 条目，并将新 FA 条目的数据块设置为指定的 ULONG64 值。

语法

PFA_ENTRY SetUlong64(
       FA_TAG  Tag,
  [in] ULONG64 Value
);

参数

Tag

FA_TAG 枚举中的值。

[in] Value

要写入新或现有 FA 条目的数据块的ULONG64值。

返回值

如果此方法成功，它将返回指向新的或现有的 FA_ENTRY 结构的指针。否则，它将返回 NULL。

注解

如果此方法找到具有指定标记的 FA 条目，它会检查与该标记关联的数据类型是 DEBUG_FA_ENTRY_ULONG64、 DEBUG_FA_ENTRY_INSTRUCTION_OFFSET还是 DEBUG_FA_ENTRY_POINTER。如果与标记关联的数据类型没有这三个值之一，则此方法返回 NULL，并且不会覆盖条目的数据块。

如果此方法找不到具有指定标记的 FA 条目，则会创建一个带有该标记的新 FA 条目，并将该标记与 数据类型DEBUG_FA_ENTRY_ULONG64相关联。