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 |