IPortableDeviceProperties::SetValues 方法 (portabledeviceapi.h)
SetValues 方法添加或修改设备上的指定对象上的一个或多个属性。
语法
HRESULT SetValues(
[in] LPCWSTR pszObjectID,
[in] IPortableDeviceValues *pValues,
[out] IPortableDeviceValues **ppResults
);
parameters
[in] pszObjectID
指向以 null 结尾的字符串的指针,该字符串包含要修改的对象的对象 ID。 若要指定设备,请使用 WPD_DEVICE_OBJECT_ID。
[in] pValues
指向包含一个或多个要设置的属性/值对的 IPortableDeviceValues 接口的指针。 现有值将被覆盖。
[out] ppResults
接收指向包含属性/HRESULT 值集合的 IPortableDeviceValues 接口的指针的变量的地址。 (类型VT_ERROR) 的每个值描述属性集尝试的成功或失败。 调用方在使用完此接口后必须释放此接口。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
所有指定的属性值都已更新。 |
|
无法修改一个或多个属性。 那些不能在检索到的 ppResults 参数中具有 VT_ERROR 类型的 HRESULT。 |
注解
若要删除属性,请调用 IPortableDeviceProperties::D elete。 仅当属性WPD_PROPERTY_ATTRIBUTE_CAN_WRITE属性为 True 时,才能删除该属性。 可以通过调用 GetPropertyAttributes 来检索此属性。
示例
有关如何使用此方法的示例,请参阅 设置单个对象的属性。
要求
目标平台 | Windows |
标头 | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |
请参阅
IPortableDeviceProperties::D elete