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 語句可以包含屬性標記、比較運算符和值規範來執行比對。 不過,您不需要 RelationSDEL 參數中的這些專案,GetRelations 方法才能正常運作(MatchSDEL 參數遵循 IWDTFTarget2::Eval 方法的規則)。
IWDTFTarget2:GetRelations 方法會將 GetRelationsRelationSDEL 語句找到的每個相關目標放入新的集合中。
GetRelations 只會傳回滿足 MatchSDEL 參數條件約束的目標子集。 如果 MatchSDEL 參數位符串是空的,GetRelations 會傳回整個目標集合。 當您提供 MatchSDEL 至目標 IWDTFTarget2::Eval 方法時,此程式會篩選出傳回VARIANT_FALSE的所有目標。
如需使用 GetRelations 方法的詳細資訊,請參閱 簡單數據評估語言概觀。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows XP Professional |
支援的最低伺服器 | Windows Server 2008 |
目標平臺 | 桌面 |
標頭 | wdtf.h |