共用方式為


WbebemRefresher::Refresh 方法 (wbemcli.h)

IWbemRefresher::Refresh 方法會更新所有可重新整理的物件、列舉值和巢狀重新整理器。 WMI 重新整理器會呼叫此函式,以 回應重新整理的用戶端要求。

語法

HRESULT Refresh(
  [in] long lFlags
);

參數

[in] lFlags

修改此方法行為的旗標位掩碼。

如果指定 了WBEM_FLAG_REFRESH_AUTO_RECONNECT ,而且連線中斷,重新整理程式就會嘗試自動重新連線至提供者。 這是這個方法的預設行為。

如果您不想讓重新整理器嘗試重新連線至提供者,請指定 WBEM_FLAG_REFRESH_NO_AUTO_RECONNECT

傳回值

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

備註

重新整理列舉值和物件時,提供者應該花費較少的時間。 使用 IWbemObjectAccess 方法和快取屬性句柄進行重複使用,可大幅改善效能。 更新列舉值時,提供者可以移除並重新具現化所有物件,或直接移除並新增已變更的實例。 您可以選擇最佳方法。 不論是哪一種情況,快取實例都可以改善效能。

提供者應該只存取重新整理程式中的物件和列舉值,以回應 IWbemRefresher::Refresh的呼叫。 不過,如果背景線程輪詢要填滿這些對象的數據,以在呼叫 Refresh 時準備,則其會非常有效。

範例

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

規格需求

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

另請參閱

開發 WMI 提供者

IWbemHiPerfProvider

IWbemRefresher

將實例提供者變成 High-Performance 提供者

效能計數器提供者

撰寫實例提供者