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 方法将 GetRelationsRelationSDEL 语句找到的每个相关目标放入新集合中。

GetRelations 仅返回满足 MatchSDEL 参数约束的目标子集。 如果 MatchSDEL 参数字符串为空,GetRelations 返回目标的完整集合。 此过程会筛选出在向目标的 IWDTFTarget2::Eval 方法提供 MatchSDEL 时返回VARIANT_FALSE的所有目标。

有关使用 GetRelations 方法的详细信息,请参阅 简单数据评估语言概述

要求

要求 价值
最低支持的客户端 Windows XP Professional
支持的最低服务器 Windows Server 2008
目标平台 桌面
标头 wdtf.h

另请参阅

IWDTFTarget2