Metode IWbemHiPerfProvider::CreateRefresher (wbemprov.h)

Artikel
08/27/2023

Metode IWbemHiPerfProvider::CreateRefresher membuat penyegaran. Penyegaran yang dikembalikan akan digunakan dalam panggilan berikutnya ke IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject, dan IWbemHiPerfProvider::StopRefreshing.

Catatan Jika penyedia tidak menerapkan metode ini, penyedia harus mengembalikan WBEM_E_PROVIDER_NOT_CAPABLE. Penyedia harus menerapkan metode ini untuk mendukung operasi penyegaran.

Sintaks

HRESULT CreateRefresher(
  [in]  IWbemServices  *pNamespace,
  [in]  long           lFlags,
  [out] IWbemRefresher **ppRefresher
);

Parameter

[in] pNamespace

Pointer IWbemServices kembali ke Manajemen Windows, yang dapat melayani permintaan apa pun yang dibuat oleh penyedia. Penyedia harus memanggil AddRef pada pointer ini jika akan memanggil kembali ke Manajemen Windows selama eksekusinya.

[in] lFlags

Dicadangkan. Parameter ini harus 0 (nol).

[out] ppRefresher

Penunjuk untuk menyimpan referensi ke implementasi penyedia antarmuka IWbemRefresher .

Mengembalikan nilai

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

Keterangan

Penyedia harus menyediakan implementasi antarmuka IWbemRefresher sendiri. WMI berlaku untuk meminta beberapa penyegar, yang masing-masing akan digunakan untuk operasi refresh sendiri.

Saat Anda merilis penyegaran, penyedia harus membersihkan objek atau enumerator yang dapat disegarkan yang ditambahkan ke penyegaran.

Contoh

Contoh kode berikut menjelaskan cara mengimplementasikan CreateRefresher.

HRESULT CHiPerfProvider::CreateRefresher(
  /* [in] */IWbemServices *pNamespace,
  /* [in] */ long lFlags,
  /* [out] */ IWbemRefresher** ppRefresher
)
{
    // Allocate a new refresher
    //For Example:
    // CMyRefresher* pMyRefresher = new CMyRefresher();

    // Return the refresher to the ppRefresher
    // [out] parameter
    /*return pMyRefresher->QueryInterface(
     IID_IWbemRefresher, (void**) ppRefresher );*/
}

// Free memory resources.
// For Example:
//pNamespace->Release();
//ppRefresher->Release();
//delete[] pMyRefresher;

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemprov.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Wmiprvsd.dll