IWbemRefresher：：Refresh 方法 (wbemcli.h)

项目
08/27/2023

IWbemRefresher：：Refresh 方法更新所有可刷新的对象、枚举器和嵌套刷新程序。 WMI 刷新程序调用此函数以响应客户端对 Refresh 的请求。

语法

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)
Library	Wbemuuid.lib