IWbemContext::Metode berikutnya (wbemcli.h)

Artikel
08/27/2023

Metode IWbemContext::Next mengambil nilai berikutnya dalam enumerasi semua nilai konteks yang dimulai dengan IWbemContext::BeginEnumeration.

Sintaks

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

Parameter

[in] lFlags

Dicadangkan. Parameter ini harus berupa 0.

[out] pstrName

Parameter ini tidak boleh NULL. Penunjuk tidak boleh menunjuk ke BSTR aktif pada entri, dan idealnya harus diatur untuk menunjuk ke NULL. Jika tidak ada kode kesalahan yang dikembalikan, kode tersebut diatur untuk menunjuk ke BSTR yang baru dialokasikan yang berisi nama nilai konteks.

Penelepon harus memanggil SysFreeString pada string yang dikembalikan ketika tidak lagi diperlukan. Jika WBEM_S_NO_MORE_DATA kembali, pstrName diatur untuk menunjuk ke NULL, dalam hal ini SysFreeString tidak boleh dipanggil. Perhatikan bahwa jika pstrName menunjuk ke BSTR yang valid pada entri, BSTR ini tidak dibebaskan, dan kebocoran memori terjadi.

[out] pValue

Parameter ini tidak boleh NULL, dan harus menunjuk ke VARIAN kosong atau tidak diinisialisasi. Jika tidak ada kesalahan yang dikembalikan, VARIAN diinisialisasi menggunakan VariantInit, lalu diatur untuk berisi nilai konteks. Pemanggil harus memanggil VariantClear pada pointer ini ketika nilai tidak lagi diperlukan. Jika kode kesalahan dikembalikan, VARIAN yang dirujuk oleh pValue dibiarkan tidak dimodifikasi.

Jika WBEM_S_NO_MORE_DATA kembali, parameter ini diatur untuk menunjuk ke VARIAN jenis VT_NULL.

Ada kemungkinan bahwa seluruh objek IWbemClassObject dapat dikembalikan di dalam VARIAN. Jika demikian, maka VT_UNKNOWN adalah jenis VARIAN . Pemanggil dapat mengambil pointer IUnknown dan menjalankan QueryInterface untuk mendapatkan pointer IWbemClassObject .

Catatan Di akhir enumerasi, WBEM_S_NO_MORE_DATA dikembalikan. VARIAN yang dikembalikan berjenis VT_NULL, dan pstrName yang dikembalikan adalah NULL.

Nilai kembali

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

Persyaratan


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	Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Lihat juga

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::EndEnumeration

Bagikan melalui