IWbemRefresher::Metode refresh (wbemcli.h)

Artikel
03/03/2024

Metode IWbemRefresher::Refresh memperbarui semua objek, enumerator, dan penyegar berlapis yang dapat disegarkan. Penyegar WMI memanggil fungsi ini sebagai respons terhadap permintaan klien untuk Refresh.

Sintaks

HRESULT Refresh(
  [in] long lFlags
);

Parameter

[in] lFlags

Bitmask bendera yang memodifikasi perilaku metode ini.

Jika WBEM_FLAG_REFRESH_AUTO_RECONNECT ditentukan dan jika koneksi rusak, penyegar mencoba menyambungkan kembali ke penyedia secara otomatis. Ini adalah perilaku default untuk metode ini.

Jika Anda tidak ingin penyegar mencoba menyambungkan kembali ke penyedia, tentukan WBEM_FLAG_REFRESH_NO_AUTO_RECONNECT.

Nilai kembali

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

Keterangan

Saat merefresh enumerator dan objek, penyedia harus membutuhkan waktu sesedikim mungkin. Menggunakan metode IWbemObjectAccess dan handel properti penembolokan untuk digunakan kembali dapat secara dramatis meningkatkan performa. Saat memperbarui enumerator, penyedia dapat menghapus dan membuat instans ulang semua objek, atau hanya menghapus dan menambahkan instans yang diubah. Terserah Anda untuk memilih pendekatan terbaik. Dalam kedua kasus, instans penembolokan dapat meningkatkan performa.

Penyedia hanya boleh mengakses objek dan enumerator dalam penyegaran sebagai respons terhadap panggilan ke IWbemRefresher::Refresh. Namun, akan sangat valid untuk memiliki polling utas latar belakang untuk data untuk mengisi objek ini, untuk mempersiapkan saat Refresh dipanggil.

Contoh

Contoh kode berikut menjelaskan cara menerapkan Refresh.

HRESULT CMyHiPerfProviderRefresher::Refresh(
/* [in] */long lFlags
)
{
  // Run through all the objects and update their
  // data.

  // Now run through the enumerators.
  // Empty the enumerator and refill it.
   

  return WBEM_S_NO_ERROR;
}

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