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

Artigo
02/06/2025

O método GetTagByName procura uma marca que tenha um nome especificado.

Sintaxe

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

Parâmetros

[in] PluginId

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o identificador de um plug-in de extensão de análise. Esse parâmetro pode ser NULL.

[in] TagName

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome a ser pesquisado.

[out] Tag

Um ponteiro para uma variável que recebe um valor na enumeração FA_TAG ou no valor de uma marca personalizada. Se esse método não encontrar uma marca que tenha o nome especificado, nada será gravado nesse parâmetro.

Valor de retorno

Se esse método encontrar uma marca que tenha o nome especificado, ele retornará S_OK. Caso contrário, ele retornará um código de falha.

Observações

Um objeto DebugFailureAnalysis tem uma coleção de entradas fa , cada uma com uma marca. Um objeto DebugFailureAnalysis está associado a um DebugFailureAnalysisTags, que contém uma coleção de propriedades de marca. Além disso, o mecanismo de análise tem uma tabela de marcas global. Para obter mais informações, consulte entradas de análise de falhas, marcas e tipos de dados.

Se você especificar um PluginId, este método fará o seguinte:

No objeto DebugFailureAnalysisTags, pesquise na coleção de propriedades de marca uma marca cujo nome corresponde TagName e cuja ID de plug-in corresponde ao PluginId. Observe que isso limita a pesquisa a marcas personalizadas criadas pelo plug-in de extensão de análise identificado pelo PluginId. Se uma correspondência for encontrada, retorne a marca no parâmetro de saída Marca.
Se uma correspondência não for encontrada no objeto DebugFailureAnalysisTags, pesquise na tabela de marcas global uma marca cujo nome corresponde TagName. Se um nome correspondente for encontrado, adicione a marca encontrada ao DebugFailureAnalysisTags coleção de propriedades de marca e retorne a marca no parâmetro de saída Tag.
Se uma correspondência não for encontrada na tabela de marcas global, não escreva nada no parâmetro Marca saída e retorne um código de falha.

Se você chamar esse método de um plug-in de extensão de análise e definir pluginId para NULL, esse método usará o identificador de plug-in do plug-in atual. Em seguida, ele se comporta da mesma maneira que quando um PluginId não NULL é especificado.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	extsfns.h

Consulte também

IDebugFAEntryTags

IDebugFailureAnalysis2

arquivos de metadados para plug-ins de extensão de análise

escrever um plug-in de extensão de análise para estender !analisar

_EFN_Analyze

Partilhar via