Метод 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

См. также раздел

IWDTFTarget2