Antarmuka IWbemObjectAccess (wbemcli.h)

Artikel
27/08/2023

Antarmuka IWbemObjectAccess menyediakan akses ke metode dan properti objek. Objek IWbemObjectAccess adalah kontainer untuk instans yang diperbarui oleh penyegaran. Dengan antarmuka IWbemObjectAccess , Anda bisa mendapatkan dan mengatur properti dengan menggunakan handel properti alih-alih nama properti objek.

Catatan Antarmuka ini tidak diimplementasikan oleh aplikasi atau penyedia klien dalam keadaan apa pun. Implementasi yang disediakan oleh WMI adalah satu-satunya yang didukung. Pointer ke antarmuka dapat diambil dengan memanggil IWbemClassObject::QueryInterface.

Warisan

Antarmuka IWbemObjectAccess mewarisi dari antarmuka IUnknown . IWbemObjectAccess juga memiliki jenis anggota ini:

Metode

Antarmuka IWbemObjectAccess memiliki metode ini.


IWbemObjectAccess::GetPropertyHandle Metode GetPropertyHandle mengembalikan handel unik yang mengidentifikasi properti. Anda dapat menggunakan handel ini untuk mengidentifikasi properti saat menggunakan metode IWbemObjectAccess untuk membaca atau menulis nilai properti.
IWbemObjectAccess::GetPropertyInfoByHandle Metode GetPropertyInfoByHandle mengembalikan nama dan jenis data properti yang terkait dengan handel properti.
IWbemObjectAccess::Lock Metode Kunci mencegah utas lain memperbarui objek IWbemObjectAccess hingga tidak terkunci.
IWbemObjectAccess::ReadDWORD Metode ReadDWORD membaca 32 bit data properti menggunakan handel properti.
IWbemObjectAccess::ReadPropertyValue Metode ReadPropertyValue mengembalikan jumlah byte tertentu dari properti yang terkait dengan handel properti.
IWbemObjectAccess::ReadQWORD Metode ReadQWORD membaca 64 bit data properti yang diidentifikasi oleh handel properti.
IWbemObjectAccess::Unlock Metode Buka Kunci memungkinkan utas lain untuk memperbarui nilai properti objek IWbemObjectAccess.
IWbemObjectAccess::WriteDWORD Metode WriteDWORD menulis 32 bit data ke properti yang diidentifikasi oleh handel properti.
IWbemObjectAccess::WritePropertyValue Metode WritePropertyValue menulis jumlah byte tertentu ke properti yang diidentifikasi oleh handel properti. Gunakan metode ini untuk mengatur string dan semua data non-DWORD atau non-QWORD lainnya.
IWbemObjectAccess::WriteQWORD Metode WriteQWORD menulis 64 bit data ke properti dengan menggunakan handel properti.

Keterangan

Metode IWbemObjectAccess yang membaca dan menulis data melakukan validasi data yang sangat sedikit. Karena metode IWbemObjectAccess mengakses properti secara langsung, Anda bisa mendapatkan dan mengatur properti jauh lebih cepat daripada yang Anda dapat menggunakan teknik akses objek standar seperti IWbemClassObject::Get dan IWbemClassObject::P ut.

Catatan Untuk memaksimalkan kecepatannya, IWbemObjectAccess benar-benar tidak dicentang. Adalah tanggung jawab pengguna untuk memastikan bahwa semua handel benar, dan bahwa buffer tulis berukuran benar. Operasi baca dan tulis tidak aman secara intrinsik utas. Anda harus memanggil metode IWbemObjectAccess::Lock dan IWbemObjectAccess::Unlock untuk mencegah objek IWbemObjectAccess dari akses bersamaan pada beberapa utas.

Handel properti sama untuk semua instans kelas. Oleh karena itu, hanya perlu untuk mengambil handel satu kali.

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)