IWbemClassObject::Metode berikutnya (wbemcli.h)
Metode IWbemClassObject::Next mengambil properti berikutnya dalam enumerasi yang dimulai dengan IWbemClassObject::BeginEnumeration. Ini harus dipanggil berulang kali untuk menghitung semua properti sampai WBEM_S_NO_MORE_DATA kembali. Jika enumerasi akan dihentikan lebih awal, maka IWbemClassObject::EndEnumeration harus dipanggil.
Urutan properti yang dikembalikan selama enumerasi tidak ditentukan.
Sintaks
HRESULT Next(
[in] long lFlags,
[out] BSTR *strName,
[out] VARIANT *pVal,
[out, optional] CIMTYPE *pType,
[out, optional] long *plFlavor
);
Parameter
[in] lFlags
Dicadangkan. Parameter ini harus berupa 0.
[out] strName
Menerima BSTR baru yang berisi nama properti. Untuk mencegah kebocoran memori dalam proses klien, pemanggil harus memanggil SysFreeString ketika nama tidak lagi diperlukan. Anda dapat mengatur parameter ini ke NULL jika nama tidak diperlukan.
[out] pVal
VARIAN ini diisi dengan nilai properti . Metode memanggil VariantInit pada VARIAN ini, sehingga pemanggil harus memastikan bahwa VARIAN tidak aktif sebelum panggilan. Pemanggil harus menggunakan VariantClear ketika nilai tidak lagi diperlukan.
Anda dapat mengatur parameter ini ke NULL jika nilainya tidak diperlukan. Jika kode kesalahan dikembalikan, VARIAN yang ditujukkan oleh pVal dibiarkan tidak dimodifikasi.
[out, optional] pType
Parameter ini bisa NULL. Jika bukan NULL, itu harus menunjuk ke variabel CIMTYPE ( LONG) tempat jenis properti ditempatkan. Ada kemungkinan bahwa nilai properti ini dapat menjadi VARIANVT_NULL, dalam hal ini perlu untuk menentukan jenis properti yang sebenarnya.
[out, optional] plFlavor
Bisa NULL. Jika bukan NULL, nilai LONG yang ditujukkan untuk menerima informasi tentang asal properti sebagai berikut. Untuk informasi selengkapnya, lihat Qualifier Flavors dan WBEM_FLAVOR_TYPE.
WBEM_FLAVOR_ORIGIN_SYSTEM
Properti adalah properti sistem standar.
Untuk kelas:
WBEM_FLAVOR_ORIGIN_PROPAGATED
Properti diwariskan dari kelas induk.
Properti , saat diwarisi dari kelas induk, belum dimodifikasi pada tingkat instans.
WBEM_FLAVOR_ORIGIN_LOCAL
Properti milik kelas turunan paling banyak.
Properti dimodifikasi pada tingkat instans (yaitu, nilai disediakan atau kualifikasi ditambahkan/dimodifikasi).
Misalnya:
Nilai kembali
Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
Keterangan
Jika jenis properti yang mendasar adalah jalur objek, tanggal atau waktu, atau jenis khusus lainnya, maka jenis yang dikembalikan tidak berisi informasi yang cukup. Pemanggil harus memeriksa CIMTYPE untuk properti yang ditentukan, dan menentukan apakah properti adalah referensi objek, tanggal atau waktu, atau jenis khusus lainnya.
Metode ini juga mengembalikan properti sistem.
Persyaratan
Klien minimum yang didukung | Windows Vista |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Windows |
Header | wbemcli.h (termasuk Wbemidl.h) |
Pustaka | WbemUuid.lib |
DLL | CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll |
Lihat juga
IWbemClassObject::BeginEnumeration