共用方式為

(wdtf.h) IWDTFTarget2：：GetRelations 方法

  • 發行項

傳回相關目標的集合。

語法

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 找到的每個相關目標放在新的集合中。

GetRelations 只會傳回符合 MatchSDEL 參數條件約束的目標子集。 如果 MatchSDEL 參數位符串是空的， GetRelations 會傳回整個目標集合。 當您將 MatchSDEL 提供給目標的 IWDTFTarget2：：Eval 方法時，此程式會篩選出傳回VARIANT_FALSE的所有目標。

如需使用 GetRelations 方法的詳細資訊，請參閱 簡單數據評估語言概觀。

規格需求

需求 值
最低支援的用戶端 Windows XP Professional
最低支援的伺服器 Windows Server 2008
目標平台 桌面
標頭 wdtf.h

另請參閱

IWDTFTarget2