次の方法で共有


IWDTFTarget2::GetValue メソッド (wdtf.h)

指定した属性に関連付けられているターゲットから値を返します。

構文

HRESULT GetValue(
  [in]          BSTR    SDEL,
  [out, retval] VARIANT *pValue
);

パラメーター

[in] SDEL

取得する属性値を指定する SDEL ステートメント。

[out, retval] pValue

このメソッドの結果を受け取る変数のアドレス。 その結果、VARIANT 任意のオートメーションと互換性があります。

戻り値

このメソッドが成功した場合は、S_OKを返します。 それ以外の場合は、HRESULT エラー コードが返されます。

備考

通常の SDEL ステートメントを使用して、 GetValue メソッドが取得するフィールドを指定します。 通常、SDEL ステートメントには、一致を実行する比較演算子と値指定子を含めることができます。 ただし、GetValue が正常に動作するためにこれらの項目は必要ありません。

SDEL ステートメントで指定されたすべてのフィールド (一連のリレーションの反復処理を含む) に対して、このメソッドは VARIANT 一連の (非VT_EMPTY) を収集します。 1 つの値のみが見つかった場合は、その VARIANT が返されます。 複数の値が見つかった場合、値は、SAFEARRAYを含む VARIANT にパッケージ化されます。 値が見つからない場合、メソッドは VT_EMPTYを含む VARIANT を返します。

さらに、AND 演算子は、それ自体の両側の値の収集を許可しますが、or では、最初に見つかった値 (左から始まる) のみを収集できます。

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

必要条件

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

関連項目

IWDTFTarget2