IWbemQualifierSet::Metode berikutnya (wbemcli.h)

Artikel
03/13/2024

Metode IWbemQualifierSet::Next mengambil kualifikasi berikutnya dalam enumerasi yang dimulai dengan IWbemQualifierSet::BeginEnumeration. Metode ini dipanggil berulang kali untuk menghitung semua kualifikasi sampai WBEM_S_NO_MORE_DATA kembali. Untuk mengakhiri enumerasi lebih awal, panggil IWbemQualifierSet::EndEnumeration.

Urutan kualifikasi yang dikembalikan selama enumerasi tidak ditentukan.

Sintaks

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pVal,
  [out] long    *plFlavor
);

Parameter

[in] lFlags

Dicadangkan. Parameter ini harus 0 (nol).

[out] pstrName

Parameter ini menerima nama kualifikasi. BSTR baru selalu dialokasikan setiap kali WBEM_S_NO_ERROR kembali.

Jika pstrNameNULL, pstrName akan diabaikan; jika tidak, pemanggil harus memastikan bahwa parameter ini tidak menunjuk ke BSTR yang valid pada entri, atau jika tidak, akan ada kebocoran memori. Selain itu, pemanggil harus ingat untuk memanggil SysFreeString pada string yang dikembalikan ketika tidak lagi diperlukan.

[out] pVal

Parameter ini menerima nilai untuk kualifikasi. VariantInit dipanggil pada VARIAN dengan metode ini. Pemanggil harus memanggil VariantClear pada pointer ini ketika nilai tidak lagi diperlukan. Jika kode kesalahan dikembalikan, VARIAN yang ditujukkan oleh pVal dibiarkan tidak dimodifikasi. Parameter ini diabaikan jika diatur ke NULL.

[out] plFlavor

Jika bukan NULL, nilai yang ditujukkan ke diatur ke ragam kualifikasi. Untuk informasi selengkapnya, lihat Qualifier Flavors dan WBEM_FLAVOR_TYPE.

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Persyaratan

Persyaratan	Nilai
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	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Lihat juga

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Rasa Kualifikasi

Bagikan melalui