WbebemRefresher：：Refresh 方法 (wbemcli.h)

發行項
03/03/2024

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