IPortableDeviceValues::GetValue メソッド
GetValue メソッドは、キーで指定された PROPVARIANT 値を取得します。
構文
HRESULT GetValue(
[in] REFPROPERTYKEY key,
[out] PROPVARIANT *pValue
);
パラメーター
-
key [in]
-
取得する項目を指定する REFPROPERTYKEY キー。
-
pValue [out]
-
取得した PROPVARIANT 値へのポインター。 呼び出し元は、その操作が完了したら PropVariantClear を呼び出してメモリを解放する必要があります。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
key で指定されたプロパティがコレクション内にありません。 |
解説
pValue の VARTYPE がVT_VECTORまたはVT_UI1の場合、NULL または 0 サイズのバッファーの取得はサポートされていません。 たとえば、pValue.caub.pElems = NULL も pValue.caub.cElems = 0 も使用できません。
このメソッドを使用して、コレクションから任意の型の値を取得できます。 ただし、値の型が事前にわかっている場合は、PROPVARIANT 値を直接操作するオーバーヘッドを回避するために、このインターフェイスの特殊な取得方法の 1 つを使用します。
必要条件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|