SWbemRefresher-Objekt

Artikel
06/29/2023

Das SWbemRefresher-Objekt ist ein Containerobjekt, das die Daten für alle Objekte aktualisieren kann, die dem Objekt hinzugefügt wurden. Einzelne Instanzen und Enumeratoren für Instanzen können dem Container hinzugefügt oder daraus entfernt werden. Der Satz der hinzugefügten Objekte, bei dem jedes Element durch eine SWbemRefreshableItem-Instanz dargestellt wird, kann als Sammlung behandelt und aufgezählt werden. WMI-Instanzen aus einer beliebigen Klasse können dem SWbemRefresher-Objekt hinzugefügt werden. Auch wenn der Anbieter für die Instanzdaten kein Hochleistungsanbieter ist, kann das Aktualisierungsobjekt die Daten im Refresh-Aufruf aktualisieren. Wenn die Daten über einen Hochleistungsanbieter bereitgestellt werden und die AutoReconnect-Eigenschaft auf TRUE festgelegt ist, versucht das SWbemRefresher-Objekt, eine unterbrochene Verbindung mit dem Datenanbieter wiederherzustellen. Dieses Objekt kann durch den VBScript-Aufruf CreateObject erstellt werden.

Der Aktualisierungsvorgang kann durch Aufrufen der SWbemRefresher.Refresh-Methode oder der SWbemObjectEx.Refresh_-Methode ausgeführt werden.

Member

Das SWbemRefresher-Objekt weist die folgenden Typen von Membern auf:

Methoden
Eigenschaften

Methoden

Das SWbemRefresher-Objekt verfügt über die folgenden Methoden.

Methode	BESCHREIBUNG
Hinzufügen	Fügt der Sammlung im Aktualisierungsobjekt ein neues aktualisierbares Objekt hinzu.
AddEnum	Fügt dem Aktualisierungsobjekt einen neuen Enumerator hinzu.
DeleteAll	Entfernt alle Elemente aus der Sammlung im Aktualisierungsobjekt.
Element	Gibt ein angegebenes Aktualisierungselement aus der Sammlung zurück.
Aktualisieren	Aktualisiert alle Elemente, die im Aktualisierungsobjekt enthalten sind.
Remove	Entfernt das Aktualisierungselementobjekt oder den Objektsatz mit einem angegebenen Index aus der Aktualisierung.

Eigenschaften

Das SWbemRefresher-Objekt verfügt über die folgenden Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
AutoReconnect	Schreibgeschützt	Gibt an, ob die Aktualisierung eine unterbrochene Verbindung mit einem Remoteanbieter automatisch wiederherstellt.
Anzahl	Schreibgeschützt	Enthält die Anzahl der Elemente im Aktualisierungsobjekt.

Beispiele

Das folgende Beispiel veranschaulicht das Erstellen eines SWbemRefresher-Objekts, die Verwendung der Methoden Add und AddEnum zum Speichern einer einzelnen Instanz und einer Enumerationsinstanz, die Aktualisierung der Daten und die Verwendung der Item-Eigenschaft zum Abrufen der SWbemRefreshableItem-Objekte.

' Get namespace connections
set objServicesCimv2 = GetObject("winmgmts:root\cimv2")
set objServicesDefault = GetObject("winmgmts:root\default")

' Create a refresher object
set objRefresher = CreateObject("WbemScripting.SWbemRefresher")

' Add a single object (SWbemObjectEx) to the refresher. The "@"
' is used because _CIMOMIdentification is a singleton class- only 
' one instance exists. Note that the
' SWbemRefreshableItem.Object property must 
' be specified or the SWbemRefresher.Refresh call will fail.

set objRefreshableItem1 = objRefresher. _
    Add (objServicesDefault, "__CIMOMIdentification=@").Object

' Add an enumerator (SWbemObjectSet object)
' to the refresher. Note that the
' SWbemRefreshableItem.ObjectSet property
' must be specified or the SWbemRefresher.Refresh call will fail. 
set objRefreshableItem2 = objRefresher. _
    AddEnum (objServicesCimv2, "Win32_Process").ObjectSet

' Display number of items in refresher and update the data.
MsgBox "Number of items in refresher = " & objRefresher.Count
objRefresher.Refresh

' Iterate through the refresher. SWbemRefreshable
' Item.IsSet checks for whether the item is an enumerator.
for each RefreshableItem in objRefresher
 if RefreshableItem.IsSet then  
    MsgBox "Item with index " & RefreshableItem.Index &_
    " is an enumerator containing "_
    & RefreshableItem.ObjectSet.Count & " processes"
 else  
      MsgBox "Item with index " & RefreshableItem.Index _
          & " is a single object containing WMI version "_
          &  objRefreshableItem1.VersionCurrentlyRunning
 end if
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_SWbemRefresher
IID	IID_ISWbemRefresher

Weitere Informationen

SWbemRefreshableItem
SWbemObjectEx
Objekte für die Skripterstellungs-API

Freigeben über