IPortableDeviceProperties::SetValues メソッド (portabledeviceapi.h)
SetValues メソッドは、デバイス上の指定したオブジェクトに対して 1 つ以上のプロパティを追加または変更します。
構文
HRESULT SetValues(
[in] LPCWSTR pszObjectID,
[in] IPortableDeviceValues *pValues,
[out] IPortableDeviceValues **ppResults
);
パラメーター
[in] pszObjectID
変更するオブジェクトのオブジェクト ID を含む null で終わる文字列へのポインター。 デバイスを指定するには、WPD_DEVICE_OBJECT_IDを使用します。
[in] pValues
設定する 1 つ以上のプロパティと値のペアを含む IPortableDeviceValues インターフェイスへのポインター。 既存の値は上書きされます。
[out] ppResults
プロパティ/HRESULT 値のコレクションを含む IPortableDeviceValues インターフェイスへのポインターを受け取る変数のアドレス。 各値 (型VT_ERROR) は、プロパティ セットの試行の成功または失敗を示します。 呼び出し元は、このインターフェイスの使用が完了したら、このインターフェイスを解放する必要があります。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
指定されたすべてのプロパティ値が更新されました。 |
|
1 つ以上のプロパティを変更できませんでした。 取得した ppResults パラメーターにVT_ERROR型の HRESULT を含められなかったもの。 |
解説
プロパティを削除するには、 IPortableDeviceProperties::D elete を呼び出します。 プロパティは、そのWPD_PROPERTY_ATTRIBUTE_CAN_WRITE属性が True の場合にのみ削除できます。 この属性は、 GetPropertyAttributes を呼び出すことによって取得できます。
例
このメソッドの使用方法の例については、「 単一オブジェクトのプロパティの設定」を参照してください。
必要条件
| 対象プラットフォーム | Windows |
| ヘッダー | portabledeviceapi.h |
| Library | PortableDeviceGUIDs.lib |
関連項目
IPortableDeviceProperties インターフェイス
IPortableDeviceProperties::D elete