Fungsi QualifierSet_BeginEnumeration

Mengatur ulang enumerator kualifikasi suatu objek ke awal enumerasi.

Catatan

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

Sintaks

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemQualifierSet.

lFlags
[in] Kombinasi bitwise dari bendera atau nilai yang dijelaskan di bagian Keterangan yang menentukan kualifikasi untuk 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	Parameter lFlags tidak valid.
WBEM_E_UNEXPECTED	0x8004101d	Panggilan kedua ke QualifierSet_BeginEnumeration dilakukan tanpa panggilan intervensi ke QualifierSet_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 IWbemQualifierSet::BeginEnumeration.

Untuk menghitung semua kualifikasi pada objek, metode ini harus dipanggil sebelum panggilan pertama ke QualifierSet_Next. Urutan di mana kualifikasi yang telah di-enumerasi dijamin invarian untuk enumerasi tertentu.

Bendera yang dapat diteruskan sebagai argumen lEnumFlags adalah yang ditentukan dalam file header WbemCli.h, atau Anda dapat menentukannya sebagai konstanta dalam kode Anda.

Terus-menerus	Nilai	Deskripsi
	0	Kembalikan nama semua kualifikasi.
WBEM_FLAG_LOCAL_ONLY	0x10	Kembalikan hanya nama kualifikasi khusus untuk properti atau objek saat ini. Untuk properti: Kembalikan hanya kualifikasi khusus untuk properti (termasuk pengambilalihan), dan bukan kualifikasi yang disebarkan dari definisi kelas. Misalnya: Kembalikan hanya nama kualifikasi khusus instans. Untuk kelas: Kembalikan hanya kualifikasi khusus untuk kelas yang diturunkan.
WBEM_FLAG_PROPAGATED_ONLY	0x20	Kembalikan hanya nama-nama kualifikasi yang disebarkan dari objek lain. Untuk properti: Kembalikan hanya kualifikasi yang disebarkan ke properti ini dari definisi kelas dan bukan yang berasal dari properti itu sendiri. Misalnya: Kembalikan hanya kualifikasi yang disebarkan dari definisi kelas. Untuk kelas: Kembalikan hanya nama kualifikasi yang diwarisi dari kelas induk.

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)