IPortableDeviceValues::SetValue メソッド
SetValue メソッドは、新しい PROPVARIANT 値を追加するか、既存の値を上書きします。
構文
HRESULT SetValue(
[in] REFPROPERTYKEY key,
[in] const PROPVARIANT *pValue
);
パラメーター
-
key [in]
-
作成または上書きする項目を指定する REFPROPERTYKEY 。
-
pValue [in]
-
新しい値を指定する PROPVARIANT 。 SDK によって値がコピーされるため、呼び出し元は、このメソッドを呼び出した後に PropVariantClear を呼び出してローカル変数を解放できます。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
注釈
pValue の VARTYPE がVT_VECTORまたはVT_UI1の場合、NULL または 0 サイズのバッファーの設定はサポートされません。 たとえば、pValue.caub.pElems = NULL でも pValue.caub.cElems = 0 も許可されません。
このメソッドを使用して、コレクションから任意の型の値を取得できます。 ただし、値の型がわかっている場合は、このインターフェイスの特殊な Set... . メソッドのいずれかを使用して、PROPVARIANT 値を直接操作するオーバーヘッドを回避します。
既存の値に key パラメーターで指定されたのと同じ キー がある場合は、警告なしで既存の値が上書きされます。 既存のキー メモリは適切に解放されます。
要件
| 要件 | 値 |
|---|---|
| ヘッダー |
|
| ライブラリ |
|