Fungsi selanjutnya

Mengambil metode berikutnya dalam enumerasi yang dimulai dengan panggilan ke BeginEnumeration.

Catatan

API ini hanya untuk penggunaan internal. API ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Sintaks

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

lFlags
[in] Dipesan. Parameter ini harus 0.

pstrName
[out] BSTR Baru yang berisi nama properti. Anda dapat mengatur parameter ini ke null jika nama tidak diperlukan.

pVal
[out] VARIANT yang diisi dengan nilai properti. Anda dapat mengatur parameter ke null ini jika nilainya tidak diperlukan. Jika fungsi mengembalikan kode galat, VARIANT yang diteruskan ke pVal dibiarkan tidak diubah.

pvtType
[out] Penunjuk ke variabel CIMTYPE (LONG tempat jenis properti ditempatkan). Nilai properti ini dapat menjadi VT_NULL_VARIANT, dalam hal ini perlu untuk menentukan jenis properti yang sebenarnya. Parameter ini juga dapat berupa null.

plFlavor
[out] null, atau nilai yang menerima informasi tentang asal properti. Lihat bagian [Komentar] untuk kemungkinan nilai.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Terus-menerus	Nilai	Deskripsi
WBEM_E_FAILED	0x80041001	Terjadi kegagalan umum.
WBEM_E_INVALID_PARAMETER	0x80041008	Parameter tidak valid.
WBEM_E_UNEXPECTED	0x8004101d	Tidak ada panggilan ke fungsi BeginEnumeration.
WBEM_E_OUT_OF_MEMORY	0x80041006	Tidak cukup memori yang tersedia untuk memulai enumerasi baru.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Panggilan prosedur jarak jauh antara proses saat ini dan Windows Management gagal.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.
WBEM_S_NO_MORE_DATA	0x40005	Tidak ada lagi properti dalam enumerasi.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::Next.

Metode ini juga mengembalikan properti sistem.

Jika jenis properti yang mendasarinya 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 guna menentukan apakah properti adalah referensi objek, tanggal atau waktu, atau jenis khusus lainnya.

Jika plFlavor bukan null, nilai LONG menerima informasi tentang asal properti, sebagai berikut:

Terus-menerus	Nilai	Deskripsi
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	Properti adalah properti sistem standar.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Untuk kelas: Properti diwarisi dari kelas induk. Misalnya: Properti, meskipun diwarisi dari kelas induk, belum diubah oleh instans.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Untuk kelas: Properti milik kelas turunan. Misalnya: Properti diubah oleh instans; yaitu, nilai disediakan, atau kualifikasi ditambahkan atau diubah.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)