Fungsi WritePropertyValue

Menulis sejumlah byte tertentu ke properti yang diidentifikasi oleh handel properti.

Catatan

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

Sintaks

HRESULT WritePropertyValue (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] long                 lHandle,
   [in] long                 lNumBytes,
   [in] byte*                aData
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemObjectAccess.

lHandle
[in] Bilangan bulat yang berisi handel yang mengidentifikasi properti ini. Handel dapat diambil dengan memanggil fungsi GetPropertyHandle.

lNumBytes
[in] Jumlah byte yang ditulis ke properti. Lihat bagian Keterangan untuk informasi lebih lanjut.

pHandle [out] Penunjuk ke array byte yang berisi data.

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_INVALID_PARAMETER	0x80041008	Parameter tidak valid.
WBEM_E_TYPE_MISMATCH	0x80041005	Terjadi ketidakcocokan jenis.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::WritePropertyValue.

Gunakan fungsi ini untuk mengatur string dan semua data non-DWORD atau non-QWORD lainnya.

Untuk nilai properti non-string, lNumBytes harus ukuran data yang benar dari jenis properti yang ditentukan. Untuk nilai properti string, lNumBytes harus berupa panjang string yang ditentukan dalam byte dan string itu sendiri harus memiliki panjang genap dalam byte, serta diikuti dengan karakter penghentian null.

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)