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 と一致し、そのプラグイン ID が PluginIdと一致するタグ タグのプロパティのコレクションを検索します。 これにより、PluginIdで識別される分析拡張機能プラグインによって作成されたカスタム タグに検索が制限されることに注意してください。 一致するものが見つかった場合は、Tag 出力パラメーターでタグを返します。
- DebugFailureAnalysisTags オブジェクトに一致するものが見つからない場合は、グローバル タグ テーブルで、名前が TagName 一致するタグを検索します。 一致する名前が見つかった場合は、タグ プロパティの DebugFailureAnalysisTags コレクションに見つかったタグを追加し、Tag 出力パラメーターでタグを返します。
- グローバル タグ テーブルに一致するものが見つからない場合は、Tag 出力パラメーターに何も書き込まず、エラー コードを返します。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | extsfns.h |
関連項目
IDebugFAEntryTags を する
分析拡張機能プラグインの 用のメタデータ ファイルの