Fungsi put

Menetapkan properti bernama ke nilai baru.

Catatan

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

Sintaks

HRESULT Put (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [in] VARIANT*          pVal,
   [in] CIMTYPE           vtType
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

wszName
[in] Nama properti. Parameter ini tidak boleh null.

lFlags
[in] Dipesan. Parameter ini harus 0.

pVal
[in] Penunjuk ke VARIANT valid yang menjadi nilai properti baru. Jika pVal adalah null atau menunjuk ke VARIANT dari jenis VT_NULL, properti diatur ke null.

vtType
[in] Jenis VARIANT yang ditujukan oleh pVal. Lihat bagian Keterangan untuk informasi lebih lanjut.

Mengembalikan nilai

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

Terus-menerus	Nilai	Deskripsi
WBEM_E_FAILED	0x80041001	Terjadi kegagalan umum.
WBEM_E_INVALID_PARAMETER	0x80041008	Satu atau beberapa parameter tidak valid.
WBEM_E_INVALID_PROPERTY_TYPE	0x8004102a	Jenis properti tidak dikenali. Nilai ini dikembalikan saat membuat instans kelas jika kelas sudah ada.
WBEM_E_OUT_OF_MEMORY	0x80041006	Tidak tersedia cukup memori untuk menyelesaikan operasi.
WBEM_E_TYPE_MISMATCH	0x80041005	Misalnya: Menunjukkan bahwa pVal menunjuk ke VARIANT dari jenis yang salah untuk properti. Untuk definisi kelas: Properti sudah ada di kelas induk, dan jenis COM baru berbeda dari jenis COM lama.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::Put.

Fungsi ini selalu menimpa nilai properti saat ini dengan yang baru. Jika IWbemClassObject menunjuk ke definisi kelas, Put membuat atau memperbarui nilai properti. Saat IWbemClassObject menunjuk ke instans CIM, Put memperbarui nilai properti saja; Put tidak dapat membuat nilai properti.

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

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

Jika properti yang diatur oleh fungsi Put 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.

Gunakan parameter vtType hanya saat membuat properti baru dalam definisi kelas CIM dan pVal merupakan null atau menunjuk ke VARIANT dari jenis VT_NULL. Dalam hal ini, parameter vType menentukan jenis CIM properti. Dalam setiap kasus lain, vtType harus 0. vtType juga harus 0 jika objek yang mendasarinya adalah instans (bahkan jika Val merupakan null) karena jenis properti diperbaiki dan tidak dapat diubah.

Contoh

Misalnya, lihat metode IWbemClassObject::Put.

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)