SWbemObjectEx.Refresh_-Methode

Artikel
07/03/2023

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

Share via