IWbemClassObject::Metode berikutnya (wbemcli.h)

Artikel
08/27/2023

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