IDebugFAEntryTags：：GetTagByName 方法（extsfns.h）

GetTagByName 方法搜索具有指定名称的标记。

语法

HRESULT GetTagByName(
  [in]  PCSTR  PluginId,
  [in]  PCSTR  TagName,
  [out] FA_TAG *Tag
);

[in] PluginId

指向以 null 结尾的字符串的指针，该字符串指定分析扩展插件的标识符。此参数可以 NULL。

[in] TagName

指向以 null 结尾的字符串的指针，指定要搜索的名称。

[out] Tag

指向一个变量的指针，该变量接收 FA_TAG 枚举中的值或自定义标记的值。如果此方法找不到具有指定名称的标记，则不会写入此参数。

如果此方法找到具有指定名称的标记，则返回 S_OK。否则，它将返回失败代码。

DebugFailureAnalysis 对象包含一组 FA 条目，每个条目都有一个标记。 DebugFailureAnalysis 对象与包含标记属性集合的 DebugFailureAnalysisTags相关联。此外，分析引擎还有一个全局标记表。有关详细信息，请参阅故障分析条目、标记和数据类型。

如果指定 PluginId，此方法将执行以下作：

在 debugFailureAnalysisTags 对象中，搜索其名称与 TagName 匹配的标记的标记属性的集合，其插件 ID 与 PluginId匹配。请注意，这会将搜索限制为由 PluginId标识的分析扩展插件创建的自定义标记。如果找到匹配项，则返回标记输出参数中的标记。
如果在 DebugFailureAnalysisTags 对象中找不到匹配项，请在全局标记表中搜索名称与 TagName 匹配的标记。如果找到匹配的名称，请将找到的标记添加到 DebugFailureAnalysisTags 标记属性集合中，并在标记输出参数中返回标记。
如果在全局标记表中找不到匹配项，则不向标记输出参数写入任何内容，并返回失败代码。