Metodo IDebugFAEntryTags::GetTagByName (extsfns.h)

Articolo
08/07/2023

Il metodo GetTagByName cerca un tag con un nome specificato.

Sintassi

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

Parametri

[in] PluginId

Puntatore a una stringa con terminazione Null che specifica l'identificatore di un plug-in di estensione di analisi. Questo parametro può essere NULL.

[in] TagName

Puntatore a una stringa con terminazione Null che specifica il nome da cercare.

[out] Tag

Puntatore a una variabile che riceve un valore nell'enumerazione FA_TAG o il valore di un tag personalizzato. Se questo metodo non trova un tag con il nome specificato, non viene scritto nulla in questo parametro.

Valore restituito

Se questo metodo trova un tag con il nome specificato, restituisce S_OK. In caso contrario, restituisce un codice di errore.

Commenti

Un oggetto DebugFailureAnalysis dispone di una raccolta di voci FA, ognuna delle quali ha un tag. Un oggetto DebugFailureAnalysis è associato a un oggetto DebugFailureAnalysisTags, che contiene una raccolta di proprietà di tag. Inoltre, il motore di analisi ha una tabella di tag globale. Per altre informazioni, vedere Voci, tag e tipi di dati di analisi degli errori.

Se si specifica un PluginId, questo metodo esegue le operazioni seguenti:

Nell'oggetto DebugFailureAnalysisTags cercare un tag il cui nome corrisponde a TagName e il cui ID plug-in corrisponde a PluginId. Si noti che questo limita la ricerca ai tag personalizzati creati dal plug-in dell'estensione di analisi identificato da PluginId. Se viene trovata una corrispondenza, restituire il tag nel parametro di output Tag .
Se non viene trovata una corrispondenza nell'oggetto DebugFailureAnalysisTags , cercare un tag nella tabella tag globale il cui nome corrisponde a TagName. Se viene trovato un nome corrispondente, aggiungere il tag trovato all'insieme DebugFailureAnalysisTags delle proprietà del tag e restituire il tag nel parametro di output Tag .
Se non viene trovata una corrispondenza nella tabella dei tag globali, scrivere nulla nel parametro di output Tag e restituire un codice di errore.

Se si chiama questo metodo da un plug-in di estensione di analisi e si imposta PluginId su NULL, questo metodo usa l'identificatore plug-in del plug-in corrente. Si comporta quindi nello stesso modo in cui viene eseguito quando viene specificato un PluginId non NULL.