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 |
---|---|
|
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 |
|
Pustaka |
|