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。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
所有指定的属性值都已更新。
S_FALSE
无法修改一个或多个属性。 那些不能在检索到的 ppResults 参数中具有 VT_ERROR 类型的 HRESULT

注解

若要删除属性,请调用 IPortableDeviceProperties::D elete。 仅当属性WPD_PROPERTY_ATTRIBUTE_CAN_WRITE属性为 True 时,才能删除该属性。 可以通过调用 GetPropertyAttributes 来检索此属性。

示例

有关如何使用此方法的示例,请参阅 设置单个对象的属性

要求

   
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

请参阅

IPortableDeviceProperties 接口

IPortableDeviceProperties::D elete

IPortableDeviceProperties::GetValues

设置单个对象的属性

写入 Content-Object 属性