IPortableDeviceContent2 ::UpdateObjectWithPropertiesAndData, méthode (portabledeviceapi.h)

La méthode UpdateObjectWithPropertiesAndData met à jour un objet à l’aide de propriétés et de données trouvées sur l’appareil.

Syntaxe

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

Paramètres

[in] pszObjectID

Identificateur de l’objet à mettre à jour.

[in] pProperties

Interface IPortableDeviceValues qui spécifie les propriétés de l’objet à mettre à jour.

[out] ppData

Interface IStream par laquelle les données d’objet sont envoyées à l’appareil.

[in, out] pdwOptimalWriteBufferSize

Taille de mémoire tampon optimale pour écrire les données d’objet dans ppData, ou NULL si la taille de la mémoire tampon est ignorée.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Toute autre valeur HRESULT indique que l’appel a échoué.

Remarques

Les formats d’appareil et les formats d’objet peuvent dériver certaines de leurs propriétés d’objet à partir des données elles-mêmes. Ou bien, ils peuvent avoir des valeurs de propriété qui dépendent des données. Par exemple, une piste musicale a une propriété duration qui est spécifiée lorsqu’une application appelle la méthode IPortableDeviceContent ::CreateObjectWithPropertiesAndData . Si cette piste est stockée en tant que ressource par défaut (WPD_RESOURCE_DEFAULT), l’application peut la mettre à jour. L’application peut également être amené à mettre à jour la propriété duration. Cette méthode permet à l’application d’effectuer les deux mises à jour en même temps.

Une mise à jour est incomplète jusqu’à ce que la méthode IStream ::Commit soit appelée sur l’objet référencé par le paramètre ppData .

Pour abandonner un transfert de données en cours, une application doit appeler la méthode IStream ::Revert sur l’objet référencé par le paramètre ppData .

L’objet d’interface IStream référencé par le paramètre ppData doit être libéré une fois l’opération de mise à jour terminée, ou est annulé.

Configuration requise