Метод 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 возвращает всю коллекцию целевых объектов. Этот процесс отфильтровывает все целевые объекты, возвращающие VARIANT_FALSE при указании MatchSDEL методу IWDTFTarget2::Eval целевого объекта.
Дополнительные сведения об использовании метода GetRelations см. в статье Обзор простого языка оценки данных.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP Professional |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdtf.h |