Método IPortableDeviceContent2::UpdateObjectWithPropertiesAndData (portabledeviceapi.h)

El método UpdateObjectWithPropertiesAndData actualiza un objeto mediante propiedades y datos encontrados en el dispositivo.

Sintaxis

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

Parámetros

[in] pszObjectID

Identificador del objeto que se va a actualizar.

[in] pProperties

La interfaz IPortableDeviceValues que especifica las propiedades del objeto que se van a actualizar.

[out] ppData

Interfaz IStream a través de la cual se envían los datos del objeto al dispositivo.

[in, out] pdwOptimalWriteBufferSize

Tamaño óptimo del búfer para escribir los datos del objeto en ppData o NULL si se omite el tamaño del búfer.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Cualquier otro valor HRESULT indica que se produjo un error en la llamada.

Comentarios

Los formatos de dispositivo y los formatos de objeto pueden derivar algunas de sus propiedades de objeto de los propios datos. O bien, pueden tener valores de propiedad que dependen de los datos. Por ejemplo, una pista de música tiene una propiedad duration que se especifica cuando una aplicación llama al método IPortableDeviceContent::CreateObjectWithPropertiesAndData . Si esta pista se almacena como un recurso predeterminado (WPD_RESOURCE_DEFAULT), la aplicación puede actualizarla. Además, la aplicación podría comportarse para actualizar la propiedad duration. Este método permite que la aplicación realice ambas actualizaciones al mismo tiempo.

Una actualización está incompleta hasta que se llama al método IStream::Commit en el objeto al que hace referencia el parámetro ppData .

Para abandonar una transferencia de datos en curso, una aplicación debe llamar al método IStream::Revert en el objeto al que hace referencia el parámetro ppData .

El objeto de interfaz IStream al que hace referencia el parámetro ppData debe liberarse una vez completada la operación de actualización, o bien se cancela.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h