Метод 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 может содержать маркеры атрибутов, операторы сравнения и описатели значений для выполнения совпадений. Однако эти элементы в параметре RelationSDEL для метода GetRelations не требуются (параметр 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 |