Antarmuka IWbemContext (wbemcli.h)

Antarmuka IWbemContext secara opsional digunakan untuk mengomunikasikan informasi konteks tambahan kepada penyedia saat mengirimkan panggilan IWbemServices ke WMI. Semua panggilan utama di IWbemServices mengambil parameter opsional yang menunjuk ke objek jenis ini.

Warisan

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

Metode

Antarmuka IWbemContext memiliki metode ini.

IWbemContext::BeginEnumeration Metode IWbemContext::BeginEnumeration mengatur ulang enumerasi semua nilai konteks dalam objek.
IWbemContext::Clone Metode IWbemContext::Clone membuat salinan logis dari objek IWbemContext saat ini. Metode ini dapat berguna ketika banyak panggilan harus dilakukan yang sebagian besar memiliki objek IWbemContext yang identik.
IWbemContext::D eleteAll Metode IWbemContext::D eleteAll menghapus semua nilai konteks bernama dari objek saat ini, sehingga mengosongkan objek.
IWbemContext::D eleteValue Metode IWbemContext::D eleteValue menghapus nilai konteks bernama yang dibuat oleh IWbemContext::SetValue.
IWbemContext::EndEnumeration Metode IWbemContext::EndEnumeration mengakhiri urutan enumerasi yang dimulai dengan IWbemContext::BeginEnumeration. Panggilan ini tidak diperlukan, tetapi dirilis sedini mungkin sumber daya sistem apa pun yang terkait dengan enumerasi.
IWbemContext::GetNames Metode IWbemContext::GetNames mengembalikan struktur SAFEARRAY dari semua nama nilai konteks bernama.
IWbemContext::GetValue Metode IWbemContext::GetValue digunakan untuk mengambil nilai konteks bernama tertentu berdasarkan nama.
IWbemContext::Berikutnya Metode IWbemContext::Next mengambil nilai berikutnya dalam enumerasi semua nilai konteks yang dimulai dengan IWbemContext::BeginEnumeration.
IWbemContext::SetValue Metode IWbemContext::SetValue membuat atau menimpa nilai konteks bernama.

Keterangan

Seringkali, penyedia dinamis memerlukan lebih banyak informasi daripada yang ditentukan dalam parameter normal metode IWbemServices . Misalnya, untuk memanipulasi objek skema WMI yang disediakannya, penyedia mungkin perlu mengetahui nama komunitas Simple Network Management Protocol (SNMP), atau database Bahasa Permintaan Terstruktur (SQL) dan nama tabel. Klien dapat menambahkan informasi ini ke objek IWbemContext dan mengirim objek IWbemContext bersama dengan panggilan sebagai salah satu parameter.

Penyedia harus menggunakan objek konten dengan hemat. Disarankan agar tidak pernah diperlukan. Jika penyedia memerlukan sejumlah besar informasi konteks yang sangat spesifik untuk menanggapi permintaan, maka semua klien harus dikodekan untuk memberikan informasi ini, sehingga melanggar model akses seragam yang menjadi dasar WMI. Namun demikian, dalam beberapa kasus itu tidak dapat dihindari. Oleh karena itu, mekanisme ini disediakan untuk memungkinkan untuk mengakses penyedia tersebut. Pengembang penyedia tersebut harus memberikan dokumentasi yang memadai sehingga pengembang perangkat lunak klien dapat berhasil memanipulasi objek CIM tersebut.

Penyedia yang mendukung penggunaan IWbemContext untuk memungkinkan klien menentukan informasi lebih lanjut dalam permintaan harus membatasi jenis nilai yang mereka dukung ke jenis dalam daftar berikut:

• VT_I4
• VT_R8
• VT_BOOL
• VT_BSTR
• VT_UNKNOWN
• Salah satu hal di atas dikombinasikan dengan VT_ARRAY

Catatan Hanya objek yang mendukung IWbemClassObject yang dapat melakukan marshal metode IUnknown mereka dalam instans IWbemContext menggunakan varian jenis VT_UNKNOWN.

 

Objek IWbemContext , yang dibuat menggunakan CoCreateInstanceEx, adalah kontainer sederhana dari nilai bernama. Akses metode ini untuk mengisi informasi konteks yang diperlukan oleh penyedia dinamis. Setelah panggilan ke salah satu metode IWbemServices , objek IWbemContext dapat digunakan kembali untuk panggilan lain, atau dapat dibatalkan alokasinya menggunakan Rilis dan objek lain yang dibuat untuk panggilan lain ke metode IWbemServices .

Informasi yang terkandung dalam objek IWbemContext sepenuhnya ditentukan oleh penyedia yang mendasar. WMI tidak menggunakan informasi, tetapi meneruskannya ke penyedia. Penyedia harus menerbitkan informasi konteks yang mereka butuhkan untuk permintaan layanan ini.

Aplikasi klien memanggil CoCreateInstanceEx untuk membuat satu objek konteks. Kemudian, ini memanggil SetValue satu atau beberapa kali untuk menyiapkan nilai konteks untuk penyedia. Akhirnya, ia mengirimkan objek ke salah satu metode IWbemServices , yang segera memanggil Rilis pada objek konteks setelah panggilan kembali. Metode lain adalah untuk digunakan terutama oleh penyedia yang menerima objek konteks dan harus mengekstrak informasi.

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)

Lihat juga

COM API untuk WMI

Membuat dan Mendeklarasikan Instans Menggunakan C++

Melakukan Panggilan ke WMI

Meminta Data WMI pada Platform 64-bit

Mengambil Bagian dari Instans WMI