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