fungsi QualifierSet_Put

Menulis kualifikasi dan nilai bernama. Kualifikasi baru menimpa nilai sebelumnya dengan nama yang sama. Jika kualifikasi tidak ada, kualifikasi akan dibuat.

Nota

API ini hanya untuk penggunaan internal. Ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Syntax

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Parameter-parameternya

vFunc
[di] Parameter ini tidak digunakan.

ptr
[di] Penunjuk ke instans IWbemQualifierSet .

wszName
[di] Nama kualifikasi yang akan ditulis.

pVal
[di] Penunjuk ke valid VARIANT yang berisi kualifikasi untuk ditulis. Parameter ini tidak boleh null.

lFlavor
[di] Salah satu konstanta berikut yang mendefinisikan rasa kualifikasi yang diinginkan untuk kualifikasi ini. Nilai defaultnya adalah WBEM_FLAVOR_OVERRIDABLE (0).

Konstanta	Nilai	Description
WBEM_FLAVOR_OVERRIDABLE	0	Kualifikasi dapat ditimpa dalam kelas atau instans turunan. Ini adalah nilai default.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE	1	Kualifikasi disebarkan ke instans.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS	2	Kualifikasi disebarkan ke kelas turunan.
WBEM_FLAVOR_NOT_OVERRIDABLE	0x10	Kualifikasi tidak dapat ditimpa dalam kelas atau instans turunan.
WBEM_FLAVOR_AMENDED	0x80	Kualifikasi dilokalkan.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini didefinisikan dalam file header WbemCli.h , atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Konstanta	Nilai	Description
WBEM_E_CANNOT_BE_KEY	0x8004101f	Ada upaya ilegal untuk menentukan Key kualifikasi pada properti yang tidak dapat menjadi kunci. Kunci ditentukan dalam definisi kelas untuk objek dan tidak dapat diubah berdasarkan per instans.
WBEM_E_INVALID_PARAMETER	0x80041008	Parameter tidak valid.
WBEM_E_INVALID_QUALIFIER_TYPE	0x80041029	Parameter pVal bukan dari jenis kualifikasi hukum.
WBEM_E_OVERRIDE_NOT_ALLOWED	0x8004101a	Tidak dimungkinkan QualifierSet_Put untuk memanggil metode pada kualifikasi karena objek pemilik tidak mengizinkan penimpaan.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Komentar

Fungsi ini membungkus panggilan ke metode IWbemQualifierSet::P ut .

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)