Метод IDebugFAEntryTags::GetTagByName (extsfns.h)

2025-04-09

Метод 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 и идентификатор подключаемого модуля соответствует PluginId. Обратите внимание, что это ограничивает поиск пользовательских тегов, созданных подключаемым модулем анализа, идентифицируемым подключаемым модулем PluginId. Если совпадение найдено, верните тег в выходном параметре Тега .
Если совпадение не найдено в объекте DebugFailureAnalysisTags , выполните поиск в глобальной таблице тегов для тега, имя которого соответствует TagName. Если найдено соответствующее имя, добавьте найденный тег в коллекцию DebugFailureAnalysisTags свойств тегов и верните тег в выходном параметре Тега .
Если совпадение не найдено в глобальной таблице тегов, ничего не записывается в выходной параметр Тега и возвращает код сбоя.

Если этот метод вызывается из подключаемого модуля расширения анализа, и вы устанавливаете PluginId значение NULL, этот метод использует идентификатор подключаемого модуля текущего подключаемого модуля. Затем он ведет себя так же, как и при указании идентификатора подключаемого модуля , отличного от NULL.