IDebugFailureAnalysis2：：SetExtensionCommand 方法（extsfns.h）

2025-02-06

SetExtensionCommand 方法搜索具有指定标记的第一个 FA 条目的 DebugFailureAnalysis 对象。如果找到具有指定标记的 FA 条目，则会将 FA 条目的数据块设置为指定的扩展命令字符串（覆盖）。如果此方法找不到具有指定标记的 FA 条目，则会使用该标记创建一个新的 FA 条目，并将新 FA 条目的数据块设置为指定的扩展命令字符串。

语法

PFA_ENTRY SetExtensionCommand(
  FA_TAG Tag,
  PCSTR  Extension
);

参数

Tag

FA_TAG 枚举中的值。

Extension

指向作为扩展命令的以 null 结尾的字符串的指针。扩展命令的示例是“！analyze -v”。

返回值

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

言论

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

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