Поделиться через

Метод 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 указывает, что вызов завершился сбоем.

Комментарии

Форматы устройств и форматы объектов могут наследовать некоторые свойства объекта из самих данных. Кроме того, они могут иметь значения свойств, которые зависят от данных. Например, музыкальная дорожка имеет свойство duration, которое указывается, когда приложение вызывает метод IPortableDeviceContent::CreateObjectWithPropertiesAndData . Если эта дорожка хранится как ресурс по умолчанию (WPD_RESOURCE_DEFAULT), приложение может обновить его. Приложение также может обновить свойство duration. Этот метод позволяет приложению выполнять оба обновления одновременно.

Обновление не выполняется до вызова метода IStream::Commit для объекта, на который ссылается параметр ppData .

Чтобы отказаться от передачи данных, приложение должно вызвать метод IStream::Revert для объекта, на который ссылается параметр ppData .

Объект интерфейса IStream , на который ссылается параметр ppData , должен быть освобожден после завершения или отмены операции обновления.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header portabledeviceapi.h