Metode IPortableDeviceValues::SetValue

Metode SetValue menambahkan nilai PROPVARIANT baru atau menimpa nilai yang sudah ada.

Sintaks

HRESULT SetValue(
  [in]       REFPROPERTYKEY key,
  [in] const PROPVARIANT    *pValue
);

Parameter

key [in]

REFPROPERTYKEY yang menentukan item untuk dibuat atau ditimpa.

pValue [in]

PROPVARIANT yang menentukan nilai baru. SDK menyalin nilai, sehingga pemanggil dapat merilis variabel lokal 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.

Mengembalikan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

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

Metode ini dapat digunakan untuk mengambil nilai dari jenis apa pun dari koleksi. Namun, jika Anda mengetahui jenis nilai terlebih dahulu, gunakan salah satu metode Set khusus... dari antarmuka ini untuk menghindari overhead bekerja dengan nilai PROPVARIANT secara langsung.

Jika nilai yang ada memiliki kunci yang sama yang ditentukan oleh parameter kunci , nilai yang ada akan ditimpa tanpa peringatan apa pun. Memori kunci yang ada dirilis dengan tepat.

Persyaratan

Persyaratan	Nilai
Header	PortableDeviceTypes.h
Pustaka	PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceValues

IPortableDeviceValues::GetValue

IPortableDeviceValues::RemoveValue