Metode IPortableDeviceValues::GetValue

Artikel
06/13/2023

Metode GetValue mengambil nilai PROPVARIANT yang ditentukan oleh kunci.

Sintaks

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

Parameter

key [in]: Kunci REFPROPERTYKEY yang menentukan item yang akan diambil.
pValue [out]: Penunjuk ke nilai PROPVARIANT yang diambil. Pemanggil harus melepaskan memori dengan memanggil PropVariantClear setelah selesai.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Properti yang ditentukan oleh kunci tidak ada dalam koleksi.

Keterangan

Ketika VARTYPE untuk pValue VT_VECTOR atau VT_UI1, mengambil 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 pengambilan khusus antarmuka ini untuk menghindari overhead bekerja dengan nilai PROPVARIANT secara langsung.

Persyaratan

Persyaratan	Nilai
Header	PortableDeviceTypes.h
Pustaka	PortableDeviceGUIDs.lib

Lihat juga

Antarmuka IPortableDeviceValues
IPortableDeviceValues::RemoveValue
IPortableDeviceValues::SetValue