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 メソッドの使用の詳細については、「単純なデータ評価言語の概要」を参照してください。

要件

こちらもご覧ください

IWDTFTarget2