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

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.

Observaciones

Un objeto DebugFailureAnalysis tiene una colección de entradas de FA, cada una de las cuales tiene una etiqueta . Un objeto DebugFailureAnalysis está asociado a un 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 de análisis de errores, etiquetas y tipos de datos.

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

• En el objeto DebugFailureAnalysisTags, busque la colección de propiedades de etiqueta para 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 la tabla de etiquetas globales de una etiqueta cuyo nombre coincida con TagName. Si se encuentra un nombre coincidente, agregue la etiqueta encontrada al DebugFailureAnalysisTags colección de propiedades de etiqueta y devuelva la etiqueta en el parámetro de salida de Etiqueta.
• Si no se encuentra una coincidencia en la tabla de etiquetas globales, escriba nada en el parámetro de salida etiqueta 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.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	extsfns.h

Consulte también

IDebugFAEntryTags

IDebugFailureAnalysis2

archivos de metadatos para complementos de extensión de análisis

escribir un complemento de extensión de análisis para ampliar !analyze

_EFN_Analyze