Metode IPortableDeviceContent::CreateObjectWithPropertiesOnly (portabledeviceapi.h)

  • Artikel

Metode CreateObjectWithPropertiesOnly membuat objek hanya dengan properti pada perangkat.

Sintaks

HRESULT CreateObjectWithPropertiesOnly(
            IPortableDeviceValues *pValues,
  [in, out] LPWSTR                *ppszObjectID
);

Parameter

pValues

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

[in, out] ppszObjectID

Penunjuk string opsional untuk menerima nama objek baru. Bisa NULL, jika tidak diperlukan. Perangkat Portabel Windows menentukan WPD_DEVICE_OBJECT_ID konstanta untuk mewakili perangkat. SDK mengalokasikan memori ini; 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 hanya berisi properti. Untuk membuat objek dengan properti dan data, gunakan CreateObjectWithPropertiesAndData.

Metode ini sinkron; ketika kembali, objek baru harus ada di perangkat.

Objek yang benar-benar dibuat driver mungkin merupakan objek properti dan data, tergantung pada jenis objek apa yang paling nyaman untuk driver. Untuk memeriksa jenis objek yang telah dibuat driver, minta properti WPD_OBJECT_FORMAT objek baru.

Objek akan dibuat pada perangkat ketika metode ini kembali.

Contoh

Untuk contoh cara menggunakan metode ini, lihat Mentransfer Objek Properties-Only ke Perangkat.

Persyaratan

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

Lihat juga

Antarmuka IPortableDeviceContent

Mentransfer Objek Properties-Only ke Perangkat