Método SWbemObjectEx.Refresh_

Artículo
06/29/2023

El método Refresh_ de SWbemObjectEx actualiza los datos de los objetos que tienen datos proporcionados por un proveedor de rendimiento, como las clases de contador de rendimiento. Puede obtener datos actualizados más rápidamente y sin una llamada a SWbemServices.Get_.

Para obtener más información sobre esta sintaxis, consulte Convenciones de documento para la API de scripting.

Sintaxis

SWbemObjectEx.Refresh_( _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parámetros

iFlags [entrada, opcional]: Marcas de operación reservadas que, si se especifican, deben ser 0 (cero).
objWbemNamedValueSet [entrada, opcional]: Objeto SWbemNamedValueSet que establece el contexto de la operación.

Valor devuelto

Este método no devuelve ningún valor.

Códigos de error

Después de completar el método Refresh_, el objeto Err puede contener uno de los códigos de error de la lista siguiente.

wbemErrFailed - 2147749889 (0x80041001): El proveedor produjo un error interno, aunque la operación fuera válida.
wbemErrNotFound: 2147749890 (0x80041002): No se encontró el formato solicitado.
wbemErrInvalidParameter - 2147749896 (0x80041008): Uno de los parámetros de la llamada no es correcto.
wbemErrRefresherBusy - 2147749975 (0x80041057): El actualizador está ocupado con otra operación.
wbemPartialResults - 2147745808 (0x80040010): No todos los objetos, enumeradores o actualizadores anidados se actualizaron correctamente. Esta devolución no es un error, sino una indicación de que la operación estaba incompleta.

Ejemplos

En el ejemplo de código de script siguiente se muestra cómo obtener contadores de rendimiento sin procesar y procesados para el proceso del sistema. Los objetos se actualizan cada dos segundos y se muestran las propiedades.

' Get the performance counter instance for the System process
set PerfRaw = GetObject( _
    "winmgmts:win32_perfrawdata_perfproc_process.name='system'")
set PerfCooked = GetObject( _
    "winmgmts:win32_perfformatteddata_perfproc_process.name='system'")

' Display some properties in a loop
for I = 1 to 5
    Wscript.Echo "HandleCount = "& PerfRaw.HandleCount & _
         " Raw ThreadCount = " & PerfRaw.ThreadCount & _
        " Cooked ThreadCount = " & PerfCooked.ThreadCount
    
    Wscript.Sleep 2000
    
' Refresh the objects
    PerfRaw.Refresh_
    PerfCooked.Refresh_
next

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
Archivo DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObjectEx
IID	IID_ISWbemObjectEx

Consulte también

SWbemObjectEx
Supervisión de datos de rendimiento