Metodo IDebugFAEntryTags::GetTagByName (extsfns.h)

Articolo
02/06/2025

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 dell'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.

Osservazioni

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

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

Nell'oggetto DebugFailureAnalysisTags cercare un tag il cui nome corrisponde TagName e il cui ID plug-in corrisponde al PluginId. Si noti che 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 nella tabella dei tag globale un tag il cui nome corrisponde TagName. Se viene trovato un nome corrispondente, aggiungere il tag trovato all'DebugFailureAnalysisTags raccolta di proprietà 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 del plug-in corrente. Si comporta quindi allo stesso modo in cui viene eseguita quando viene specificato un PluginId non NULL.