Metode IPortableDeviceValues::GetValue (portabledevicetypes.h)

  • Artikel

Antarmuka GetValue mengambil nilai PROPVARIANT yang ditentukan oleh kunci.

Sintaks

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

Parameter

[in] key

Kunci REFPROPERTYKEY yang menentukan item yang akan diambil.

[out] pValue

Penunjuk ke nilai PROPVARIANT yang diambil. Pemanggil harus melepaskan memori dengan memanggil PropVariantClear ketika panggilan selesai.

Nilai kembali

Metode mengembalikan HRESULT. Kemungkinan nilai yang dikembalikan diperlihatkan dalam tabel berikut ini.

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

Keterangan

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 pemeriksaan jenis tambahan.

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.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header portabledevicetypes.h

Lihat juga

Antarmuka IPortableDeviceValues

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue