IDebugFAEntryTags：：GetTagByName 方法 (extsfns.h)

GetTagByName 方法會搜尋具有指定名稱的標記。

語法

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

[in] PluginId

指定分析延伸模組外掛程式識別碼之 Null 終止字串的指標。此參數可以是 Null。

[in] TagName

以 Null 結尾字串的指標，指定要搜尋的名稱。

[out] Tag

變數的指標，接收 FA_TAG 列舉中的值或自定義標記的值。如果這個方法找不到具有指定名稱的標記，則不會寫入此參數。

如果此方法找到具有指定名稱的標記，則會 傳回S_OK。否則會傳回失敗碼。

DebugFailureAnalysis 物件具有FA專案的集合，每個專案都有標記。 DebugFailureAnalysis 物件與 DebugFailureAnalysisTags 相關聯，其中包含標記屬性的集合。此外，分析引擎也有全域標籤數據表。如需詳細資訊，請參閱失敗分析專案、標記和數據類型。

如果您指定 PluginId，此方法會執行下列動作：

在 DebugFailureAnalysisTags 物件中，搜尋名稱符合 TagName 且外掛程式識別元符合 PluginId 的標記屬性集合。請注意，這會將搜尋限制為 由 PluginId 所識別之分析延伸模組外掛程式所建立的自定義標籤。如果找到相符專案，請傳回Tag輸出參數中的標記。
如果在 DebugFailureAnalysisTags 物件中找不到相符專案，請在全域標記數據表中搜尋名稱符合 TagName 的標記。如果找到相符的名稱，請將找到的標記新增至Tag屬性的 DebugFailureAnalysisTags 集合，並在Tag輸出參數中傳回標記。
如果在全域標籤數據表中找不到相符專案，請將任何專案寫入 Tag 輸出參數，並傳回失敗碼。