Metode IWbemClassObject::P ut (wbemcli.h)

Artikel
03/08/2023

Metode IWbemClassObject::P ut menetapkan properti bernama ke nilai baru. Metode ini selalu menimpa nilai saat ini dengan yang baru. Ketika IWbemClassObject menunjuk ke definisi kelas CIM, Put membuat atau memperbarui nilai properti. Saat IWbemClassObject menunjuk ke instans CIM, Letakkan pembaruan nilai properti saja. Put tidak dapat membuat nilai properti.

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

Sintaks

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] long    lFlags,
  [in] VARIANT *pVal,
  [in] CIMTYPE Type
);

Parameter

[in] wszName

Parameter yang harus menunjuk ke nama properti yang valid. Parameter ini tidak boleh NULL.

[in] lFlags

Dicadangkan. Parameter ini harus 0 (nol).

[in] pVal

Parameter yang harus menunjuk ke VARIAN yang valid, yang menjadi nilai properti baru. Jika pValNULL atau menunjuk ke VARIAN jenis VT_NULL, properti diatur ke NULL, yaitu, tidak ada nilai.

[in] Type

Jenis VARIAN yang ditujukkan oleh pVal.

Nilai NULL untuk properti yang ditunjuk oleh VARIAN jenis VT_NULL dibedakan dari properti jenis VT_I4 dengan nilai 0 (nol).

Saat membuat properti baru, jika pValadalah NULL atau menunjuk ke VT_NULL, jenis properti ditentukan dari parameter vtType .

Jika pVal berisi IWbemClassObject yang disematkan, pemanggil harus memanggil IWbemClassObject::QueryInterface untuk IID_IUnknown dan menempatkan penunjuk yang dihasilkan di VARIAN menggunakan jenis VT_UNKNOWN. Objek sematkan asli disalin selama operasi Put , sehingga tidak dapat dimodifikasi oleh operasi.

Penunjuk diperlakukan sebagai baca-saja. Pemanggil harus memanggil VariantClear setelah panggilan ini selesai.

Gunakan parameter ini hanya saat membuat properti baru dalam definisi kelas CIM dan pVal adalah NULL atau menunjuk ke VARIAN jenis VT_NULL. Dalam kasus seperti itu, parameter vtType menentukan jenis CIM properti. Dalam setiap kasus lainnya, vtType harus 0 (nol). Selain itu, vtType harus 0 (nol) ketika objek yang mendasar adalah instans (bahkan jika pValNULL), karena jenis properti diperbaiki dan tidak dapat diubah. Dengan kata lain, gunakan vtType jika, dan hanya jika, pValadalah NULL atau menunjuk ke VARIAN VT_NULL, dan objek yang mendasarinya adalah kelas CIM.

Saat menggunakan IWbemClassObject::P ut untuk menetapkan nilai array kosong ke properti, Anda tidak perlu menentukan jenis VT yang tepat; Anda dapat menetapkan nilai ke pVal yang merupakan VARIAN dengan jenis varian VT_ARRAY|VT_VARIANT.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.

Keterangan

Jika properti yang ditetapkan oleh metode IWbemClassObject::P ut ada di kelas induk, nilai default properti diubah kecuali jenis properti tidak cocok dengan jenis kelas induk. Jika properti tidak ada dan bukan ketidakcocokan jenis, maka properti dibuat.

Saat menjalankan metode ini pada instans, penimpaan selalu terjadi, karena properti selalu ada.

Saat membuat kelas baru dan jenis properti yang mendasarinya adalah referensi objek, string tanggal/waktu, atau jenis khusus lainnya, Anda mungkin perlu memodifikasi parameter jenis CIM untuk properti guna menunjukkan kelas baru khusus. Kualifikasi CIMType pada properti instans bersifat baca-saja dan diwarisi dari objek kelas.

Jika jenis varian yang ditentukan dalam pVal tidak cocok dengan jenis CIM properti, WMI mencoba mengubah varian ke jenis varian yang sesuai, menggunakan aturan koersi varian normal. Jika varian tidak dapat dipaksa, WBEM_E_TYPE_MISMATCH dikembalikan. Daftar berikut ini mencantumkan pengecualian untuk aturan pemaksaan varian normal saat properti adalah jenis uint32.

Meneruskan jenis varian	Hasil
VT_I4	S_OK
VT_I2	WBEM_TYPE_MISMATCH
VT_R8	S_OK Namun, meneruskan VT_ARRAY\|VT_R8 ke properti jenis uint32[] akan gagal.

Properti sistem __CLASS hanya dapat ditulis selama pembuatan kelas, ketika mungkin tidak dibiarkan kosong. Semua properti sistem lainnya hanya bersifat baca-saja.

Contoh

Contoh kode berikut menunjukkan cara mengatur nama kelas untuk kelas CIM baru.

// pObj is an empty object from IWbemServices::GetObject
// Set up the property value.
VARIANT v; 
VariantInit(&v);
V_VT(&v) = VT_BSTR;
V_BSTR(&v) = SysAllocString(L"MyClass");

// Write it.
LPCWSTR strClassProp = L"__CLASS";
pObj->Put(strClassProp, 0, &v, 0);

// Clean up.
VariantClear(&v);

Contoh kode berikut menunjukkan cara mengatur nilai properti SomeUint64. Ketahuilah bahwa nilai BSTR harus dalam format desimal dan bukan heksadesimal.

// pObj is an instance containing a uint64 property
// Set up the property value.
VARIANT v; 
VariantInit(&v);
V_VT(&v) = VT_BSTR;
V_BSTR(&v) = SysAllocString(L"1033"); // - decimal format, not hex

// Write it.
LPCWSTR strClassProp = L"SomeUint64";
pObj->Put(strClassProp, 0, &v, CIM_UINT64);

// Clean up.
VariantClear(&v);

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	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll