IWbemHiPerfProvider：：CreateRefresher 方法 (wbemprov.h)

發行項
08/27/2023

IWbemHiPerfProvider：：CreateRefresher方法會建立重新整理器。傳回的重新整理程式將用於後續 IWbemHiPerfProvider：：CreateRefreshableEnum、 IWbemHiPerfProvider：：CreateRefreshableObject和 IWbemHiPerfProvider：：StopRefreshing 的後續呼叫中。

注意如果提供者未實作此方法，則必須傳回 WBEM_E_PROVIDER_NOT_CAPABLE。提供者必須實作這個方法來支援重新整理作業。

語法

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

參數

[in] pNamespace

IWbemServices指標回到 Windows 管理，可服務提供者提出的任何要求。如果提供者在執行期間要回呼 Windows Management，提供者應該在此指標上呼叫 AddRef 。

[in] lFlags

保留的。此參數必須是 0 (零) 。

[out] ppRefresher

要保存提供者實作 IWbemRefresher 介面之參考的指標。

傳回值

這個方法會傳回 HRESULT ，指出方法呼叫的狀態。下列清單列出 HRESULT中包含的值。

備註

提供者必須提供自己的 IWbemRefresher 介面實作。 WMI 可以要求多個重新整理程式，每個重新整理都會用於自己的重新整理作業。

當您釋放重新整理器時，提供者應該清除已新增至重新整理器的任何可重新整理物件或列舉值。

範例

下列程式碼範例說明如何實作 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;

規格需求


最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	wbemprov.h (包含 Wbemidl.h)
程式庫	Wbemuuid.lib
Dll	Wmiprvsd.dll