IWDTFTarget2::GetValue メソッド (wdtf.h)
指定した属性に関連付けられているターゲットから値を返します。
構文
HRESULT GetValue(
[in] BSTR SDEL,
[out, retval] VARIANT *pValue
);
パラメーター
[in] SDEL
取得する属性値を指定する SDEL ステートメント。
[out, retval] pValue
このメソッドの結果を受け取る変数のアドレス。 結果には、オートメーション互換の VARIANT を指定できます。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
GetValue メソッドが取得するフィールドは、通常の SDEL ステートメントを使用して指定します。 通常、SDEL ステートメントには、一致を実行するための比較演算子と値指定子を含めることができます。 ただし、 GetValue が正常に動作するためにこれらの項目は必要ありません。
SDEL ステートメントで指定されたすべてのフィールド (一連のリレーションの反復処理を含む) について、このメソッドは一連の (VT_EMPTY以外の) VARIANT 値を収集します。 1 つの値のみが見つかった場合、その VARIANT が返されます。 複数の値が見つかった場合、値は SAFEARRAY を含む VARIANT にパッケージ化されます。 値が見つからない場合、メソッドはVT_EMPTYを含む VARIANT を返します。
さらに、 AND 演算子はそれ自体の両側の値の収集を許可しますが、 OR は最初に見つかった値 (左から始まる) の収集のみを許可します。
GetValue の使用の詳細については、「Simple Data Evaluation Language Overview」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP Professional |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | デスクトップ |
| Header | wdtf.h |