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로 식별된 분석 확장 플러그 인에서 만든 사용자 지정 태그로 검색이 제한됩니다. 일치 항목이 발견되면 태그 출력 매개 변수에 태그를 반환합니다.
DebugFailureAnalysisTags 개체에 일치하는 항목이 없으면 이름이 TagName과 일치하는 태그에 대해 전역 태그 테이블을 검색합니다. 일치하는 이름을 찾은 경우 태그 속성의 DebugFailureAnalysisTags 컬렉션에 찾은 태그를 추가하고 태그 출력 매개 변수에 태그를 반환합니다.
전역 태그 테이블에 일치하는 항목이 없으면 태그 출력 매개 변수에 아무 것도 쓰지 않고 실패 코드를 반환합니다.