Метод IWbemHiPerfProvider::StopRefreshing (wbemprov.h)

Статья
08/27/2023

Метод IWbemHiPerfProvider::StopRefreshing прекращает обновление объекта или перечислителя, соответствующего указанному идентификатору. Средство обновления WMI вызывает этот метод в ответ на запрос клиента к IWbemConfiguratorRefresher::Remove. Поставщик должен проверка объекты и перечислители, связанные с средством обновления, для соответствующего идентификатора. Когда поставщик находит идентификатор, поставщик должен удалить или освободить перечислитель.

Примечание Если поставщик не реализует этот метод, он должен вернуть WBEM_E_PROVIDER_NOT_CAPABLE. Поставщик должен реализовать StopRefreshing , если он реализует IWbemHiPerfProvider::CreateRefreshableEnum или IWbemHiPerfProvider::CreateRefreshableObject.

Синтаксис

HRESULT StopRefreshing(
  [in] IWbemRefresher *pRefresher,
  [in] long           lId,
  [in] long           lFlags
);

Параметры

[in] pRefresher

Указатель на объект IWbemRefresher , содержащий средство обновления, полученное путем вызова IWbemHiPerfProvider::CreateRefresher.

[in] lId

Целое число, содержащее идентификатор средства обновления, который однозначно идентифицирует объект для остановки обновления.

[in] lFlags

Целое число, содержащее флаги.

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT.

Нет необходимости вызывать StopRefreshing для очистки средства обновления. Достаточно просто удалить средство обновления; то есть, чтобы освободить все ссылки на него. Удаление средства обновления приводит к очистке всех объектов и перечислителей в нем.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemprov.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Wmiprvsd.dll