SWbemObjectEx.Refresh_-Methode

Die Refresh_-Methode von SWbemObjectEx aktualisiert die Daten für Objekte, deren Daten von einem Leistungsanbieter bereitgestellt werden, z. B. die Leistungsindikatorklassen. Sie können aktualisierte Daten schneller und ohne einen Aufruf von SWbemServices.Get_ erhalten.

Weitere Informationen zu dieser Syntax finden Sie unter Dokumentkonventionen für die Skript-API.

Syntax

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

Parameter

iFlags [in, optional]

Reservierte Vorgangsflags, die, falls angegeben, 0 (Null) sein müssen.

objWbemNamedValueSet [in, optional]

Ein SWbemNamedValueSet-Objekt, das den Kontext für den Vorgang festlegt.

Rückgabewert

Diese Methode gibt keinen Wert zurück.

Fehlercodes

Nach Abschluss der Refresh_-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste.

wbemErrFailed – 2147749889 (0x80041001)

Es liegt ein interner Anbieterfehler vor, obwohl der Vorgang gültig war.

wbemErrNotFound – 2147749890 (0x80041002)

Das angeforderte Format wurde nicht gefunden.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Einer der Parameter für den Aufruf ist nicht korrekt.

wbemErrRefresherBusy – 2147749975 (0x80041057)

Die Aktualisierungsroutine ist mit einer anderen Operation ausgelastet.

wbemPartialResults – 2147745808 (0x80040010)

Nicht alle Objekte, Enumeratoren oder geschachtelten Aktualisierungen wurden erfolgreich aktualisiert. Diese Rückgabe ist kein Fehler, sondern ein Hinweis darauf, dass der Vorgang unvollständig war.

Beispiele

Im folgenden Skriptcode-Beispiel wird gezeigt, wie Sie sowohl rohe als auch aufbereitete Leistungsindikatoren für den Systemprozess erhalten. Die Objekte werden alle zwei Sekunden aktualisiert, und die Eigenschaften werden angezeigt.

' 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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemObjectEx
IID
IID_ISWbemObjectEx

Weitere Informationen

SWbemObjectEx

Überwachen von Leistungsdaten