Método IWbemHiPerfProvider::CreateRefresher (wbemprov.h)

Artículo
03/05/2025

El método IWbemHiPerfProvider::CreateRefresher crea un actualizador. El actualizador devuelto se usará en llamadas posteriores a IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObjecty IWbemHiPerfProvider::StopRefreshing.

Nota Si un proveedor no implementa este método, debe devolver WBEM_E_PROVIDER_NOT_CAPABLE. Un proveedor debe implementar este método para admitir operaciones del actualizador.

Sintaxis

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

Parámetros

[in] pNamespace

Un IWbemServices puntero a administración de Windows, que puede atender cualquier solicitud realizada por el proveedor. El proveedor debe llamar a AddRef en este puntero si va a volver a llamar a administración de Windows durante su ejecución.

[in] lFlags

Reservado. Este parámetro debe ser 0 (cero).

[out] ppRefresher

Puntero para contener la referencia a la implementación del proveedor de la interfaz IWbemRefresher.

Valor devuelto

Este método devuelve un HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor incluido en un HRESULT.

Observaciones

El proveedor debe proporcionar su propia implementación de la interfaz IWbemRefresher. Es válido para que WMI solicite varios actualizadores, cada uno de los cuales se usará para sus propias operaciones de actualización.

Al liberar un actualizador, el proveedor debe limpiar los objetos o enumeradores actualizables que se agregaron al actualizador.

Ejemplos

En el ejemplo de código siguiente se describe cómo implementar 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;

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
de la plataforma de destino de	Windows
encabezado de	wbemprov.h (include Wbemidl.h)
biblioteca de	Wbemuuid.lib
DLL de	Wmiprvsd.dll