Metode IDeviceSpecificProperty::SetValue (devicetopology.h)

  • Artikel

Metode SetValue menetapkan nilai properti khusus perangkat.

Sintaks

HRESULT SetValue(
  [in] void    *pvValue,
  [in] DWORD   cbValue,
  [in] LPCGUID pguidEventContext
);

Parameter

[in] pvValue

Arahkan ke nilai baru untuk properti khusus perangkat.

[in] cbValue

Ukuran dalam byte dari nilai properti khusus perangkat.

[in] pguidEventContext

Nilai konteks untuk metode IControlChangeNotify::OnNotify . Parameter ini menunjuk ke GUID konteks peristiwa. Jika panggilan SetValue mengubah status kontrol, semua klien yang telah mendaftarkan antarmuka IControlChangeNotify dengan kontrol tersebut menerima pemberitahuan. Dalam implementasi metode OnNotify , klien dapat memeriksa GUID konteks peristiwa untuk menemukan apakah itu atau klien lain adalah sumber peristiwa perubahan kontrol. Jika penelepon menyediakan pointer NULL untuk parameter ini, metode pemberitahuan klien menerima penunjuk konteks NULL .

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK. Jika gagal, kemungkinan kode pengembalian menyertakan, tetapi tidak terbatas pada, nilai yang diperlihatkan dalam tabel berikut.

Menampilkan kode Deskripsi
E_POINTER
 Pointer pvValue adalah NULL.
E_INVALIDARG
 Parameter cbValue tidak cocok dengan ukuran nilai properti yang diperlukan.
E_OUTOFMEMORY
 Kehabisan memori.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header devicetopology.h

Lihat juga

Antarmuka IDeviceSpecificProperty