IDebugFAEntryTags：：GetTagByName 方法（extsfns.h）

發行項
02/06/2025

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 的標籤標。如果找到相符的名稱，請將找到的標籤新增至 DebugFailureAnalysisTags 標記屬性的集合，並在 Tag 輸出參數中傳回標記。
如果在全域標記數據表中找不到相符專案，則不會將任何內容寫入 Tag 輸出參數，並傳回失敗碼。