IWDTFTarget2::GetRelations メソッド (wdtf.h)
関連するターゲットのコレクションを返します。
構文
HRESULT GetRelations(
[in] BSTR RelationSDEL,
[in] BSTR MatchSDEL,
[out, retval] IWDTFTargets2 **ppRelations
);
パラメーター
[in] RelationSDEL
目的のターゲットを指定する 1 つ以上のリレーション トークンを含む SDEL ステートメント。
[in] MatchSDEL
返される各ターゲットが一致する必要がある SDEL ステートメント。 MatchSDEL が空の場合、すべてのターゲットが返されます。
[out, retval] ppRelations
このメソッドの結果を受け取る変数のアドレス。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
GetRelations メソッドを使用して、IWDTFTarget2 インターフェイスの関連インスタンスを取得します。 関係 SDEL ステートメントで目的のターゲットを指定します。 通常、SDEL ステートメントには、属性トークン、比較演算子、および一致を実行する値指定子を含めることができます。 ただし、GetRelations メソッドの RelationSDEL パラメーターにこれらの項目が正しく機能する必要はありません (MatchSDEL パラメーターは、IWDTFTarget2::Eval メソッドの規則に従います)。
IWDTFTarget2:GetRelations メソッドは、RelationSDEL ステートメントによって GetRelations によって検出されるすべての関連ターゲットを新しいコレクションに配置します。
GetRelations は、MatchSDEL パラメーター制約を満たすターゲットのサブセットのみを返します。 MatchSDEL パラメーター文字列が空の場合、GetRelations はターゲットのコレクション全体を返します。 このプロセスでは、ターゲットの IWDTFTarget2::Eval メソッドに MatchSDEL を指定すると、VARIANT_FALSEを返すすべてのターゲットが除外されます。
GetRelations メソッドの使用の詳細については、「単純なデータ評価言語の概要」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP Professional |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | デスクトップ |
| Header | wdtf.h |