Metode IWMDMDevice3::SetProperty (mswmdm.h)

Artikel
08/25/2023

Metode SetProperty mengatur properti perangkat tertentu, jika dapat ditulis.

Sintaks

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

Parameter

[in] pwszPropName

Karakter lebar, nama string properti yang dihentikan null untuk diatur. Ini menimpa properti yang ada dengan nama yang sama. Setelah aplikasi melakukan panggilan ini, aplikasi harus membebaskan memori dinamis apa pun menggunakan PropVariantClear. Daftar konstanta nama properti standar diberikan dalam Konstanta Metadata.

[in] pValue

Nilai properti yang sedang diatur.

Nilai kembali

Metode mengembalikan HRESULT. Semua metode antarmuka di Windows Media Device Manager dapat mengembalikan salah satu kelas kode kesalahan berikut:

Kode kesalahan COM standar
Kode kesalahan Windows dikonversi ke nilai HRESULT
Kode galat Pengelola Perangkat Windows Media

Untuk daftar ekstensif kemungkinan kode kesalahan, lihat Kode Kesalahan.

Keterangan

Metode ini menetapkan properti perangkat yang ditentukan. Untuk mendapatkan daftar properti perangkat yang didukung, klien harus meminta metode IWMDMDevice3::GetProperty untuk properti g_wszWMDMSupportedDeviceProperties .

Untuk daftar nama properti perangkat, lihat Konstanta Metadata.

Metode ini mirip dengan metode SetMetadata untuk penyimpanan, tetapi metode ini hanya dapat mengatur satu properti pada satu waktu.

Tidak semua properti perangkat dapat diatur.