IPortableDevicePropVariantCollection::Tambahkan metode

Metode Tambahkan menambahkan item ke koleksi.

Sintaks

HRESULT Add(
  [in] const PROPVARIANT *pValue
);

Parameter

pValue [in]

Arahkan ke objek PROPVARIANT baru untuk ditambahkan ke koleksi. Metode ini menyalin PROPVARIANT ke koleksi, jadi Anda harus merilis salinan lokal variabel Anda dengan memanggil PropVariantClear setelah memanggil metode ini.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Ketika VARTYPE untuk pValue VT_VECTOR atau VT_UI1, pengaturan dan pengambilan buffer NULL atau berukuran nol tidak didukung. Misalnya, pValue.caub.pElems = NULL atau pValue.caub.cElems = 0 tidak diizinkan.

Jika penelepon mencoba menambahkan item VARTYPE berbeda yang terkandung dalam koleksi dan nilai PROPVARIANT tidak dapat diubah oleh antarmuka ini secara otomatis, metode ini akan gagal. Untuk mengubah jenis koleksi secara manual, panggil IPortableDevicePropVariantCollection::ChangeType.

Contoh

Untuk contoh cara menggunakan metode ini, lihat Mengambil Pengidentifikasi Objek dari Pengidentifikasi Unik Persisten

Persyaratan

Persyaratan	Nilai
Header	PortableDeviceTypes.h
Pustaka	PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDevicePropVariantCollection

Memindahkan Konten pada Perangkat

Mengambil Pengidentifikasi Objek dari Pengidentifikasi Unik Persisten