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 메서드는 RelationSDEL 문에서 찾은 GetRelations 모든 관련 대상을 새 컬렉션에 배치합니다.
GetRelationsMatchSDEL 매개 변수 제약 조건을 충족하는 대상의 하위 집합만 반환합니다. MatchSDEL 매개 변수 문자열이 비어 있으면 GetRelations 전체 대상 컬렉션을 반환합니다. 이 프로세스는 대상의 IWDTFTarget2::Eval 메서드에 MatchSDEL 제공할 때 VARIANT_FALSE 반환하는 모든 대상을 필터링합니다.
GetRelations 메서드를 사용하는 방법에 대한 자세한 내용은 간단한 데이터 평가 언어 개요참조하세요.
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP Professional |
지원되는 최소 서버 | Windows Server 2008 |
대상 플랫폼 | 바탕 화면 |
헤더 | wdtf.h |