Metode IWbemConfigureRefresher::AddEnum (wbemcli.h)

Artikel
03/13/2024

Metode IWbemConfigureRefresher::AddEnum menambahkan enumerator ke penyegaran yang diminta.

Sintaks

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

Parameter

[in] pNamespace

Pointer IWbemServices kembali ke Manajemen Windows, yang dapat melayani permintaan apa pun yang dibuat oleh penyedia. Jika metode harus memanggil kembali ke Manajemen Windows selama eksekusinya, penyedia harus memanggil AddRef dengan pointer pNamespace .

[in] wszClassName

String konstanta yang dihentikan null dari karakter Unicode 16-bit yang berisi nama kelas yang dijumlahkan.

[in] lFlags

Bitmask bendera yang memodifikasi perilaku metode ini. Jika parameter ini diatur ke WBEM_FLAG_USE_AMENDED_QUALIFIERS, instans yang dikembalikan berisi kualifikasi yang dilokalkan jika tersedia.

[in] pContext

Biasanya NULL; jika tidak, ini adalah penunjuk ke objek IWbemContext yang diperlukan oleh satu atau beberapa penyedia kelas dinamis. Nilai dalam objek konteks harus ditentukan dalam dokumentasi penyedia tertentu. Untuk informasi selengkapnya tentang parameter ini, lihat Melakukan Panggilan ke WMI.

[out] ppEnum

Pointer yang menyimpan referensi ke objek IWbemHiPerfEnum , yang akan berisi enumerasi. Klien harus memanggil Rilis pada pointer ini ketika tidak lagi diperlukan.

[out] plId

Penunjuk ke bilangan bulat yang dikembalikan oleh penyedia yang secara unik mengidentifikasi enumerasi yang dapat disegarkan.

Nilai kembali

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

CatatanHRESULT

Keterangan

Kelas yang disediakan harus menentukan kelas yang valid, yang disediakan oleh Penyedia High-Performance. Semua instans enumerator yang dikembalikan dapat dikueri setelah panggilan. Pada setiap panggilan untuk di-refresh, jumlah instans dalam enumerator dapat bervariasi. Hanya instans dari nama kelas yang ditentukan yang dikembalikan; subkelas kelas yang ditentukan tidak akan dijumlahkan karena enumerasi terperinci tidak didukung. Enumerator yang dikembalikan tidak boleh disentuh oleh klien saat operasi Refresh sedang dalam proses. Pengidentifikasi yang dikembalikan dapat digunakan oleh fungsi Hapus untuk menghapus objek. Perhatikan bahwa pengguna tidak perlu menghapus enumerator yang ditambahkan secara eksplisit. Namun, klien harus memanggil Rilis pada enumerator yang dikembalikan ketika tidak lagi diperlukan.

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

Lihat juga

IWbemConfigureRefresher

Bagikan melalui