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 |