Metode IWbemQualifierSet::P ut (wbemcli.h)

Artikel
03/03/2024

Metode IWbemQualifierSet::P ut menulis kualifikasi dan nilai bernama. Pengkualifikasi baru menulis ulang nilai sebelumnya dengan nama yang sama. Jika pengkualifikasi tidak ada, maka akan dibuat.

Terkadang tidak mungkin untuk menulis nilai kualifikasi, misalnya, jika kualifikasi disebarluaskan dari objek lain. Biasanya, kualifikasi yang disebarkan bersifat baca-saja, tetapi dapat ditimpa. Untuk informasi selengkapnya, lihat Qualifier Flavors.

Saat menggunakan kualifikasi Kunci , tidak perlu menentukan ragam atau aturan penyebaran apa pun.

Pengguna tidak boleh membuat kualifikasi dengan nama yang dimulai atau diakhir dengan garis bawah (_). Ini disediakan untuk kelas dan properti sistem.

Sintaks

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] VARIANT *pVal,
  [in] long    lFlavor
);

Parameter

[in] wszName

Nama kualifikasi yang sedang ditulis. Penunjuk diperlakukan sebagai baca-saja.

[in] pVal

Tidak boleh NULL. Ini harus menunjuk ke VARIAN yang valid yang berisi nilai kualifikasi yang akan ditulis. Penunjuk diperlakukan sebagai baca-saja. Pemanggil bertanggung jawab untuk memanggil VariantClear pada pointer ini setelah nilai tidak diperlukan.

Hanya varian dan array jenis VT_I4, VT_R8, VT_BSTR, VT_BOOL yang didukung.

[in] lFlavor

Rasa kualifikasi yang diinginkan untuk kualifikasi ini. Daftar berikut mencantumkan konstanta yang sesuai untuk lFlavor. Nilai defaultnya adalah nol (0).

WBEM_FLAVOR_OVERRIDABLE (0 (0x0))

Nilai kualifikasi dapat ditimpa di kelas turunan atau instans. Ini adalah default. Menggunakan konstanta ini sama dengan menggunakan bendera EnableOverride .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1))

Pengkualifikasi disebarluaskan ke instans. Menggunakan konstanta ini sama dengan menggunakan bendera ToInstance .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2))

Pengkualifikasi disebarluaskan ke kelas turunan. Menggunakan konstanta ini sama dengan menggunakan bendera ToSubClass .

WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10))

Nilai kualifikasi tidak dapat ditimpa dalam kelas turunan atau instans. Menggunakan konstanta ini sama dengan menggunakan bendera DisableOverride .

WBEM_FLAVOR_AMENDED (128 (0x80))

Pengkualifikasi dilokalkan. Menggunakan konstanta ini sama dengan menggunakan bendera Diubah .

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Lihat juga

Rasa Kualifikasi

Bagikan melalui