fungsi QualifierSet_Next

Mengambil kualifikasi berikutnya dalam enumerasi yang dimulai dengan panggilan ke fungsi QualifierSet_BeginEnumeration .

Catatan

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

Sintaks

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parameter

vFunc [in] Parameter ini tidak digunakan.

ptr [in] Penunjuk ke instans IWbemQualifierSet.

lFlags [in] Dipesan. Parameter ini harus 0.

pstrName [out] Nama pengkualifikasi. Jika null, parameter ini diabaikan; jika tidak, pstrName tidak boleh menunjuk ke BSTR yang valid atau terjadi kebocoran memori. Jika bukan null, fungsi selalu mengalokasikan BSTR baru saat mengembalikan WBEM_S_NO_ERROR.

pVal [out] Jika berhasil, nilai untuk pengkualifikasi. Jika fungsi gagal, VARIANT yang ditunjuk oleh pVal tidak diubah. Jika parameter ini adalah null, parameter tersebut akan diabaikan.

plFlavor [out] Penunjuk ke LONG yang menerima ragam pengkualifikasi. Jika informasi ragam tidak diinginkan, parameter ini bisa berupa null.

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 tidak valid.
WBEM_E_UNEXPECTED	0x8004101d	Pemanggil tidak memanggil QualifierSet_BeginEnumeration.
WBEM_E_OUT_OF_MEMORY	0x80041006	Memori tidak cukup tersedia untuk memulai enumerasi baru.
WBEM_S_NO_MORE_DATA	0x40005	Tidak ada lagi kualifikasi yang tersisa dalam enumerasi.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemQualifierSet::Next.

Anda memanggil fungsi QualifierSet_Next berulang kali untuk menghitung semua kualifikasi hingga fungsi mengembalikan WBEM_S_NO_MORE_DATA. Untuk mengakhiri enumerasi lebih awal, panggil fungsi QualifierSet_EndEnumeration.

Urutan kualifikasi yang dikembalikan selama enumerasi tidak terdefinisi.

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)