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 はターゲットのコレクション全体を返します。 このプロセスでは、MatchSDEL をターゲットの IWDTFTarget2::Eval メソッドに指定すると、VARIANT_FALSEを返すすべてのターゲットが除外されます。

GetRelations メソッドの使用の詳細については、「単純なデータ評価言語の概要 を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows XP Professional
サポートされる最小サーバー	Windows Server 2008
ターゲット プラットフォーム の	デスクトップ
ヘッダー	wdtf.h

関連項目

IWDTFTarget2