SWbemRefresher-Objekt
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
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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemRefresher |
| IID |
IID_ISWbemRefresher |