Metode IPortableDeviceContent::CreateObjectWithPropertiesAndData (portabledeviceapi.h)

Metode CreateObjectWithPropertiesAndData membuat objek dengan properti dan data pada perangkat.

Sintaks

HRESULT CreateObjectWithPropertiesAndData(
            IPortableDeviceValues *pValues,
  [out]     IStream               **ppData,
  [in, out] DWORD                 *pdwOptimalWriteBufferSize,
  [in, out] LPWSTR                *ppszCookie
);

Parameter

pValues

Kumpulan properti IPortableDeviceValues untuk ditetapkan ke objek. Untuk daftar properti yang diperlukan dan opsional untuk objek, lihat Persyaratan untuk Objek.

[out] ppData

Alamat variabel yang menerima penunjuk ke antarmuka IStream yang digunakan aplikasi untuk mengirim data objek ke perangkat. Objek tidak akan dibuat pada perangkat sampai aplikasi mengirim data dengan memanggil ppData-Commit>. Untuk mengabaikan transfer data yang sedang berlangsung, Anda dapat memanggil ppData ->Kembali. Pemanggil harus merilis antarmuka ini ketika selesai dengannya. Objek yang mendasar memperluas IStream dan IPortableDeviceDataStream.

[in, out] pdwOptimalWriteBufferSize

Penunjuk DWORD opsional yang menentukan ukuran buffer optimal untuk digunakan aplikasi saat menulis data ke ppData. Aplikasi dapat menentukan TRUE untuk mengabaikan ini.

[in, out] ppszCookie

ID string unik dan dihentikan null opsional yang digunakan untuk mengidentifikasi permintaan pembuatan ini dalam implementasi aplikasi IPortableDeviceEventCallback (jika diimplementasikan). Ketika perangkat selesai membuat objek, perangkat akan mengirim pengidentifikasi ini ke fungsi panggilan balik. Pengidentifikasi ini memungkinkan aplikasi untuk memantau pembuatan objek di utas yang berbeda dari yang disebut CreateObjectWithPropertiesOnly. SDK mengalokasikan memori ini, dan pemanggil harus merilisnya menggunakan CoTaskMemFree.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Setidaknya salah satu argumen yang diperlukan adalah penunjuk NULL .

Keterangan

Beberapa objek hanya merupakan kumpulan properti—seperti folder, yang hanya merupakan kumpulan penunjuk ke objek lain—sementara objek lain adalah properti dan data—seperti file audio, yang berisi semua properti dan bit musik yang sebenarnya. Metode ini digunakan untuk membuat objek yang memerlukan properti dan data. Untuk membuat objek khusus properti, panggil CreateObjectWithPropertiesOnly.

Karena objek tidak dibuat sampai aplikasi memanggil Commit pada IStreamppData yang diambil, objek tidak akan memiliki ID sampai Commit dipanggil di atasnya. Penerapan sinkron, jadi ketika metode tersebut berhasil dikembalikan, objek akan ada di perangkat.

Setelah memanggil Commit untuk membuat objek, panggil QueryInterface di ppData untuk IPortableDeviceDataStream, lalu panggil IPortableDeviceDataStream::GetObjectID untuk mendapatkan ID objek yang baru dibuat.

Contoh

Untuk contoh cara menggunakan metode ini, lihat Mentransfer File Gambar atau Musik ke Perangkat.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	portabledeviceapi.h
Pustaka	PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceContent

Antarmuka IPortableDeviceDataStream

Mentransfer File Gambar atau Musik ke Perangkat