Metode IPortableDeviceContent2::UpdateObjectWithPropertiesAndData (portabledeviceapi.h)

Artikel
03/04/2024

Metode UpdateObjectWithPropertiesAndData memperbarui objek dengan menggunakan properti dan data yang ditemukan di perangkat.

Sintaks

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

Parameter

[in] pszObjectID

Pengidentifikasi objek yang akan diperbarui.

[in] pProperties

Antarmuka IPortableDeviceValues yang menentukan properti objek yang akan diperbarui.

[out] ppData

Antarmuka IStream tempat data objek dikirim ke perangkat.

[in, out] pdwOptimalWriteBufferSize

Ukuran buffer optimal untuk menulis data objek ke ppData, atau NULL jika ukuran buffer diabaikan.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Nilai HRESULT lainnya menunjukkan bahwa panggilan gagal.

Keterangan

Format perangkat dan format objek dapat memperoleh beberapa properti objeknya dari data itu sendiri. Atau, mereka dapat memiliki nilai properti yang bergantung pada data. Misalnya, trek musik memiliki properti durasi yang ditentukan saat aplikasi memanggil metode IPortableDeviceContent::CreateObjectWithPropertiesAndData . Jika trek ini disimpan sebagai sumber daya default (WPD_RESOURCE_DEFAULT), aplikasi mungkin memperbaruinya. Aplikasi ini juga mungkin berpotensi memperbarui properti durasi. Metode ini memungkinkan aplikasi melakukan kedua pembaruan secara bersamaan.

Pembaruan tidak lengkap sampai metode IStream::Commit dipanggil pada objek yang dirujuk oleh parameter ppData .

Untuk meninggalkan transfer data yang sedang berlangsung, aplikasi harus memanggil metode IStream::Revert pada objek yang direferensikan oleh parameter ppData .

Objek antarmuka IStream yang direferensikan oleh parameter ppData harus dirilis setelah operasi pembaruan selesai, atau, dibatalkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	portabledeviceapi.h

Bagikan melalui