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
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
Membuat dan Mendeklarasikan Instans Menggunakan C++