SystemRestore-Klasse

Artikel
06/13/2023

Stellt Methoden zum Deaktivieren und Aktivieren der Überwachung, zum Auflisten verfügbarer Wiederherstellungspunkte und zum Initiieren einer Wiederherstellung auf dem lokalen System bereit.

Syntax

class SystemRestore
{
  String Description;
  uint32 RestorePointType;
  uint32 EventType;
  uint32 SequenceNumber;
  String CreationTime;
};

Member

Die SystemRestore-Klasse verfügt über die folgenden Membertypen:

Methoden
Eigenschaften

Methoden

Die SystemRestore-Klasse verfügt über diese Methoden.

Methode	BESCHREIBUNG
CreateRestorePoint	Erstellt einen Wiederherstellungspunkt.
Deaktivieren	Deaktiviert die Überwachung auf einem bestimmten Laufwerk.
Aktivieren	Ermöglicht die Überwachung auf einem bestimmten Laufwerk.
GetLastRestoreStatus	Ruft den status der letzten Systemwiederherstellung ab.
Wiederherstellen	Initiiert eine Systemwiederherstellung.

Eigenschaften

Die SystemRestore-Klasse verfügt über diese Eigenschaften.

CreationTime

Datentyp: Zeichenfolge
Zugriffstyp: Lese-/Schreibzugriff

Der Zeitpunkt, zu dem die Zustandsänderung aufgetreten ist.

Beschreibung

Datentyp: Zeichenfolge
Zugriffstyp: Lese-/Schreibzugriff

Die beschreibung, die angezeigt werden soll, damit der Benutzer einen Wiederherstellungspunkt leicht identifizieren kann. Die maximale Länge einer ANSI-Zeichenfolge ist MAX_DESC. Die maximale Länge einer Unicode-Zeichenfolge ist MAX_DESC_W. Weitere Informationen finden Sie unter Wiederherstellungspunktbeschreibungstext.

EventType

Datentyp: uint32
Zugriffstyp: Lese-/Schreibzugriff

Art des Ereignisses. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
BEGIN_NESTED_SYSTEM_CHANGE 102	Ein Systemwechsel hat begonnen. Ein anschließender geschachtelter Aufruf erstellt keinen neuen Wiederherstellungspunkt. Nachfolgende Aufrufe müssen END_NESTED_SYSTEM_CHANGE und nicht END_SYSTEM_CHANGE verwenden.
BEGIN_SYSTEM_CHANGE 100	Ein Systemwechsel hat begonnen.
END_NESTED_SYSTEM_CHANGE 103	Eine Systemänderung wurde beendet.
END_SYSTEM_CHANGE 101	Eine Systemänderung wurde beendet.

RestorePointType

Datentyp: uint32
Zugriffstyp: Lese-/Schreibzugriff

Der Typ des Wiederherstellungspunkts. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
APPLICATION_INSTALL 0	Eine Anwendung wurde installiert.
APPLICATION_UNINSTALL 1	Eine Anwendung wurde deinstalliert.
CANCELLED_OPERATION 13	Eine Anwendung muss den erstellten Wiederherstellungspunkt löschen. Beispielsweise würde eine Anwendung dieses Flag verwenden, wenn ein Benutzer eine Installation abbricht.
DEVICE_DRIVER_INSTALL 10	Ein Gerätetreiber wurde installiert.
MODIFY_SETTINGS 12	Für eine Anwendung wurden Features hinzugefügt oder entfernt.

SequenceNumber

Datentyp: uint32
Zugriffstyp: Lese-/Schreibzugriff
Qualifizierer: Schlüssel

Die Sequenznummer des Wiederherstellungspunkts.

Bemerkungen

Sie können eine Liste von Wiederherstellungspunkten abrufen, indem Sie die SWbemServices.InstancesOf-Methode verwenden, um eine Auflistung von SystemRestore-Objekten abzurufen. Sie können die Klasseneigenschaften verwenden, um den Wiederherstellungspunkt zu identifizieren.

Beispiele

Das folgende Beispielskript listet die aktuellen Wiederherstellungspunkte auf.

'SystemRestore Class
'Provides methods for disabling and enabling monitoring, 
'listing available restore points, and initiating a 
'restore on the local system.

Set RPSet = GetObject("winmgmts:root/default").InstancesOf ("SystemRestore")
for each RP in RPSet
    wscript.Echo "Dir: RP" & RP.SequenceNumber & ", Name: " & RP.Description & ", Type: ", RP.RestorePointType & ", Time: " & RP.CreationTime
next

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Namespace	Stamm\Standard
MOF	Sr.mof

Siehe auch

Windows-Verwaltungsinstrumentation

Share via