Método IWbemRefresher::Refresh (wbemcli.h)

Artículo
08/27/2023

El método IWbemRefresher::Refresh actualiza todos los objetos actualizables, enumeradores y actualizadores anidados. WMI Refresher llama a esta función en respuesta a una solicitud de cliente a Refresh.

Sintaxis

HRESULT Refresh(
  [in] long lFlags
);

Parámetros

[in] lFlags

Máscara de bits de marcas que modifican el comportamiento de este método.

Si se especifica WBEM_FLAG_REFRESH_AUTO_RECONNECT y si se interrumpe la conexión, el actualizador intenta volver a conectarse al proveedor automáticamente. Este es el comportamiento predeterminado de este método.

Si no desea que el actualizador intente volver a conectarse al proveedor, especifique WBEM_FLAG_REFRESH_NO_AUTO_RECONNECT.

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

Al actualizar los enumeradores y objetos, los proveedores deben tardar el menor tiempo posible. El uso de los métodos IWbemObjectAccess y los identificadores de propiedad de almacenamiento en caché para su reutilización pueden mejorar considerablemente el rendimiento. Al actualizar los enumeradores, un proveedor puede quitar y volver a crear instancias de todos los objetos, o simplemente quitar y agregar las instancias modificadas. Le corresponde elegir el mejor enfoque. En cualquier caso, el almacenamiento en caché de instancias puede mejorar el rendimiento.

El proveedor solo debe tener acceso a los objetos y enumeradores de un actualizador en respuesta a una llamada a IWbemRefresher::Refresh. Sin embargo, sería perfectamente válido tener un sondeo de subproceso en segundo plano para los datos con los que rellenar estos objetos, para prepararse para cuando se llama a Refresh .

Ejemplos

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib