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 출력 매개 변수에 아무 것도 쓰지 않고 실패 코드를 반환합니다.