Метод IWbemRefresher::Refresh (wbemcli.h)

Статья
03/09/2024

Метод 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
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib