IPortableDeviceContent2：：UpdateObjectWithPropertiesAndData 方法 (portabledeviceapi.h)

UpdateObjectWithPropertiesAndData 方法使用设备上找到的属性和数据更新对象。

语法

HRESULT UpdateObjectWithPropertiesAndData(
  [in]      LPCWSTR               pszObjectID,
  [in]      IPortableDeviceValues *pProperties,
  [out]     IStream               **ppData,
  [in, out] DWORD                 *pdwOptimalWriteBufferSize
);

参数

[in] pszObjectID

要更新的对象标识符。

[in] pProperties

指定要更新的对象属性 的 IPortableDeviceValues 接口。

[out] ppData

对象数据发送到设备的 IStream 接口。

[in, out] pdwOptimalWriteBufferSize

将对象数据写入 ppData 的最佳缓冲区大小;如果忽略缓冲区大小，则为 NULL 。

返回值

如果方法成功，则返回 S_OK。 任何其他 HRESULT 值都表示调用失败。

注解

设备格式和对象格式可以从数据本身派生其某些对象属性。 或者，它们可以具有依赖于数据的属性值。 例如，音乐曲目具有在应用程序调用 IPortableDeviceContent：：CreateObjectWithPropertiesAndData 方法时指定的 duration 属性。 如果此轨迹存储为默认资源 (WPD_RESOURCE_DEFAULT) ，则应用程序可能会更新它。 应用程序可能还会更新 duration 属性。 此方法允许应用程序同时执行这两个更新。

更新是不完整的，直到对 ppData 参数引用的对象调用 IStream：：Commit 方法。

若要放弃正在进行的数据传输，应用程序应对 ppData 参数引用的对象调用 IStream：：Revert 方法。

ppData 参数引用的 IStream 接口对象必须在更新操作完成或取消后释放。

要求