Método IDebugFAEntryTags::GetTagByName (extsfns.h)

Artículo
08/07/2023

El método GetTagByName busca una etiqueta que tenga un nombre especificado.

Sintaxis

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

Parámetros

[in] PluginId

Puntero a una cadena terminada en null que especifica el identificador de un complemento de extensión de análisis. Este parámetro puede ser NULL.

[in] TagName

Puntero a una cadena terminada en null que especifica el nombre que se va a buscar.

[out] Tag

Puntero a una variable que recibe un valor en la enumeración FA_TAG o el valor de una etiqueta personalizada. Si este método no encuentra una etiqueta que tenga el nombre especificado, no se escribe nada en este parámetro.

Valor devuelto

Si este método encuentra una etiqueta que tiene el nombre especificado, devuelve S_OK. De lo contrario, devuelve un código de error.

Comentarios

Un objeto DebugFailureAnalysis tiene una colección de entradas fa, cada una de las cuales tiene una etiqueta . Un objeto DebugFailureAnalysis está asociado a un Objeto DebugFailureAnalysisTags, que contiene una colección de propiedades de etiqueta. Además, el motor de análisis tiene una tabla de etiquetas global. Para obtener más información, vea Entradas, etiquetas y tipos de datos de análisis de errores.

Si especifica un PluginId, este método hace lo siguiente:

En el objeto DebugFailureAnalysisTags , busque en la colección de propiedades de etiqueta una etiqueta cuyo nombre coincida con TagName y cuyo identificador de complemento coincida con el PluginId. Tenga en cuenta que esto limita la búsqueda a etiquetas personalizadas creadas por el complemento de extensión de análisis identificado por PluginId. Si se encuentra una coincidencia, devuelva la etiqueta en el parámetro de salida Tag .
Si no se encuentra una coincidencia en el objeto DebugFailureAnalysisTags , busque en la tabla de etiquetas globales una etiqueta cuyo nombre coincida con TagName. Si se encuentra un nombre coincidente, agregue la etiqueta encontrada a la colección DebugFailureAnalysisTags de propiedades de etiqueta y devuelva la etiqueta en el parámetro de salida Tag .
Si no se encuentra una coincidencia en la tabla de etiquetas globales, escriba nada en el parámetro de salida Tag y devuelva un código de error.

Si llama a este método desde un complemento de extensión de análisis y establece PluginId en NULL, este método usa el identificador de complemento del complemento actual. A continuación, se comporta de la misma manera que cuando se especifica un pluginId que no es NULL.