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

Статья
08/27/2023

Метод IWbemHiPerfProvider::CreateRefresher создает средство обновления. Возвращенное средство обновления будет использоваться в последующих вызовах IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject и IWbemHiPerfProvider::StopRefreshing.

Примечание Если поставщик не реализует этот метод, он должен вернуть WBEM_E_PROVIDER_NOT_CAPABLE. Поставщик должен реализовать этот метод для поддержки операций обновления.

Синтаксис

HRESULT CreateRefresher(
  [in]  IWbemServices  *pNamespace,
  [in]  long           lFlags,
  [out] IWbemRefresher **ppRefresher
);

Параметры

[in] pNamespace

Указатель IWbemServices обратно на управление Windows, который может обслуживать любой запрос, сделанный поставщиком. Поставщик должен вызвать AddRef для этого указателя, если он собирается вернуться к управлению Windows во время его выполнения.

[in] lFlags

Зарезервировано. Этот параметр должен иметь значение 0 (ноль).

[out] ppRefresher

Указатель для хранения ссылки на реализацию поставщика интерфейса IWbemRefresher .

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

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

Поставщик должен предоставить собственную реализацию интерфейса IWbemRefresher . WMI может запрашивать несколько средств обновления, каждый из которых будет использоваться для собственных операций обновления.

При выпуске средства обновления поставщик должен очистить все обновляемые объекты или перечислители, добавленные в средство обновления.

Примеры

В следующем примере кода описывается реализация CreateRefresher.

HRESULT CHiPerfProvider::CreateRefresher(
  /* [in] */IWbemServices *pNamespace,
  /* [in] */ long lFlags,
  /* [out] */ IWbemRefresher** ppRefresher
)
{
    // Allocate a new refresher
    //For Example:
    // CMyRefresher* pMyRefresher = new CMyRefresher();

    // Return the refresher to the ppRefresher
    // [out] parameter
    /*return pMyRefresher->QueryInterface(
     IID_IWbemRefresher, (void**) ppRefresher );*/
}

// Free memory resources.
// For Example:
//pNamespace->Release();
//ppRefresher->Release();
//delete[] pMyRefresher;

Требования


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