Fungsi BeginEnumeration

Mengatur ulang enumerator kembali ke awal enumerasi.

Catatan

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

Sintaks

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

lEnumFlags
[in] Kombinasi bitwise dari bendera atau nilai yang dijelaskan di bagian Keterangan yang mengontrol properti yang disertakan dalam enumerasi.

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_INVALID_PARAMETER	0x80041008	Kombinasi bendera di lEnumFlags tidak valid, atau argumen yang tidak valid ditentukan.
WBEM_E_UNEXPECTED	0x8004101d	Panggilan kedua ke BeginEnumeration dilakukan tanpa panggilan intervensi ke EndEnumeration.
WBEM_E_OUT_OF_MEMORY	0x80041006	Tidak cukup memori yang tersedia untuk memulai enumerasi baru.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::BeginEnumeration.

Bendera yang dapat diteruskan sebagai argumen lEnumFlags adalah yang ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda. Anda dapat menggabungkan satu bendera dari setiap grup dengan bendera apa pun dari grup lain. Namun, bendera dari grup yang sama saling eksklusif.

Grup 1

Terus-menerus	Nilai	Deskripsi
WBEM_FLAG_KEYS_ONLY	0x4	Sertakan properti yang merupakan kunci saja.
WBEM_FLAG_REFS_ONLY	0x8	Sertakan properti yang hanya referensi objek.

Grup 2

Terus-menerus	Nilai	Deskripsi
WBEM_FLAG_SYSTEM_ONLY	0x30	Batasi enumerasi hanya untuk properti sistem.
WBEM_FLAG_NONSYSTEM_ONLY	0x40	Sertakan properti lokal dan disebarluaskan tetapi kecualikan properti sistem dari enumerasi.

Untuk kelas:

Terus-menerus	Nilai	Deskripsi
WBEM_FLAG_CLASS_OVERRIDES_ONLY	0x100	Batasi enumerasi ke properti yang ditimpa dalam definisi kelas.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES	0x100	Batasi enumerasi ke properti yang diambil alih dalam definisi kelas saat ini dan ke properti baru yang ditentukan dalam kelas.
WBEM_MASK_CLASS_CONDITION	0x300	Masker (bukan bendera) untuk diterapkan terhadap nilai lEnumFlags untuk memeriksa apakah WBEM_FLAG_CLASS_OVERRIDES_ONLY atau WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES diatur.
WBEM_FLAG_LOCAL_ONLY	0x10	Batasi enumerasi ke properti yang ditentukan atau dimodifikasi di kelas itu sendiri.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Batasi enumerasi ke properti yang diwarisi dari kelas dasar.

Misalnya:

Terus-menerus	Nilai	Deskripsi
WBEM_FLAG_LOCAL_ONLY	0x10	Batasi enumerasi ke properti yang ditentukan atau dimodifikasi di kelas itu sendiri.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Batasi enumerasi ke properti yang diwarisi dari kelas dasar.

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)