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

Artículo
08/27/2023

El método IWbemHiPerfProvider::CreateRefresher crea un actualizador. El actualizador devuelto se usará en llamadas posteriores a IWbemHiPerfProvider::CreateRefreshableEnum, IWbemHiPerfProvider::CreateRefreshableObject e 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 puntero IWbemServices 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 la administración de Windows durante su ejecución.

[in] lFlags

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

[out] ppRefresher

Puntero que contiene la referencia a la implementación del proveedor de la interfaz IWbemRefresher .

Valor devuelto

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

Comentarios

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


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemprov.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Wmiprvsd.dll