Metode IPortableDeviceProperties::SetValues (portabledeviceapi.h)

Artikel
03/15/2023

Metode SetValues menambahkan atau memodifikasi satu atau beberapa properti pada objek tertentu pada perangkat.

Sintaks

HRESULT SetValues(
  [in]  LPCWSTR               pszObjectID,
  [in]  IPortableDeviceValues *pValues,
  [out] IPortableDeviceValues **ppResults
);

Parameter

[in] pszObjectID

Penunjuk ke string yang dihentikan null yang berisi ID objek objek yang akan dimodifikasi. Untuk menentukan perangkat, gunakan WPD_DEVICE_OBJECT_ID.

[in] pValues

Penunjuk ke antarmuka IPortableDeviceValues yang berisi satu atau beberapa pasangan properti/nilai untuk diatur. Nilai yang ada akan ditimpa.

[out] ppResults

Alamat variabel yang menerima penunjuk ke antarmuka IPortableDeviceValues yang berisi kumpulan nilai properti/HRESULT. Setiap nilai (jenis VT_ERROR) menjelaskan keberhasilan atau kegagalan upaya set properti. Pemanggil harus merilis antarmuka ini ketika selesai dengannya.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
S_OK	Semua nilai properti yang ditentukan telah diperbarui.
S_FALSE	Satu atau beberapa properti tidak dapat diubah. Mereka yang tidak akan memiliki HRESULT jenis VT_ERROR dalam parameter ppResults yang diambil.

Keterangan

Untuk menghapus properti, panggil IPortableDeviceProperties::D elete. Properti hanya dapat dihapus jika atribut WPD_PROPERTY_ATTRIBUTE_CAN_WRITE-nya True. Atribut ini dapat diambil dengan memanggil GetPropertyAttributes.