다음을 통해 공유

IWDTFTarget2::GetRelations 메서드(wdtf.h)

  • 아티클

관련 대상의 컬렉션을 반환합니다.

구문

HRESULT GetRelations(
  [in]          BSTR          RelationSDEL,
  [in]          BSTR          MatchSDEL,
  [out, retval] IWDTFTargets2 **ppRelations
);

매개 변수

[in] RelationSDEL

원하는 대상을 지정하는 하나 이상의 관계 토큰을 포함하는 SDEL 문입니다.

[in] MatchSDEL

반환된 각 대상이 일치해야 하는 SDEL 문입니다. MatchSDEL이 비어 있으면 모든 대상이 반환됩니다.

[out, retval] ppRelations

이 메서드의 결과를 받을 변수의 주소입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

GetRelations 메서드를 사용하여 IWDTFTarget2 인터페이스의 관련 인스턴스를 검색합니다. 관계 SDEL 문으로 원하는 대상을 지정합니다. 일반적으로 SDEL 문에는 일치를 수행하는 특성 토큰, 비교 연산자 및 값 지정자가 포함될 수 있습니다. 그러나 GetRelations 메서드가 제대로 작동하려면 RelationSDEL 매개 변수에 이러한 항목이 필요하지 않습니다(MatchSDEL 매개 변수는 IWDTFTarget2::Eval 메서드에 대한 규칙을 따릅니다).

IWDTFTarget2:GetRelations 메서드는 GetRelations가 RelationSDEL 문에서 찾은 모든 관련 대상을 새 컬렉션에 배치합니다.

GetRelations는MatchSDEL 매개 변수 제약 조건을 충족하는 대상의 하위 집합만 반환합니다. MatchSDEL 매개 변수 문자열이 비어 있으면 GetRelations는 대상의 전체 컬렉션을 반환합니다. 이 프로세스는 대상의 IWDTFTarget2::Eval 메서드에 MatchSDEL을 제공할 때 VARIANT_FALSE 반환하는 모든 대상을 필터링합니다.

GetRelations 메서드 사용에 대한 자세한 내용은 단순 데이터 평가 언어 개요를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP Professional
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 데스크톱
머리글 wdtf.h

추가 정보

IWDTFTarget2