CreateRestorePoint-Methode der SystemRestore-Klasse

Artikel
06/13/2023

Erstellt einen Wiederherstellungspunkt.

Diese Methode ist die skriptfähige Entsprechung der SRSetRestorePoint-Funktion .

Syntax

uint32 CreateRestorePoint(
  [in] String Description,
  [in] uint32 RestorePointType,
  [in] uint32 EventType
);

Parameter

Beschreibung [in]

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.

RestorePointType [in]

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

Wiederherstellungspunkttyp	Bedeutung
APPLICATION_INSTALL 0	Eine Anwendung wurde installiert.
APPLICATION_UNINSTALL 1	Eine Anwendung wurde deinstalliert.
DEVICE_DRIVER_INSTALL 10	Ein Gerätetreiber wurde installiert.
MODIFY_SETTINGS 12	Für eine Anwendung wurden Features hinzugefügt oder entfernt.
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.

EventType [in]

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

Ereignistyp	Bedeutung
BEGIN_NESTED_SYSTEM_CHANGE 102	Ein Systemwechsel hat begonnen. Bei einem nachfolgenden geschachtelten Aufruf wird kein neuer Wiederherstellungspunkt erstellt. Nachfolgende Aufrufe müssen END_NESTED_SYSTEM_CHANGE und nicht END_SYSTEM_CHANGE verwenden.
BEGIN_SYSTEM_CHANGE 100	Ein Systemwechsel hat begonnen. Bei einem nachfolgenden Aufruf muss END_SYSTEM_CHANGE und nicht END_NESTED_SYSTEM_CHANGE verwendet werden.
END_NESTED_SYSTEM_CHANGE 103	Ein Systemwechsel wurde beendet.
END_SYSTEM_CHANGE 101	Ein Systemwechsel wurde beendet.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der com-Fehlercodes zurück, die in WinError.h definiert sind.

Bemerkungen

**Windows 8: **

Mit einem neuen Registrierungsschlüssel können Anwendungsentwickler die Häufigkeit der Erstellung von Wiederherstellungspunkten ändern.

Anwendungen sollten diesen Schlüssel erstellen, um ihn zu verwenden, da er im System nicht vorhanden ist. Wenn der Schlüssel nicht vorhanden ist, gilt standardmäßig Folgendes. Wenn eine Anwendung die CreateRestorePoint-Methode aufruft, um einen Wiederherstellungspunkt zu erstellen, überspringt Windows die Erstellung dieses neuen Wiederherstellungspunkts, wenn in den letzten 24 Stunden Wiederherstellungspunkte erstellt wurden. Die CreateRestorePoint-Methode gibt S_OK zurück.

Entwickler können Anwendungen schreiben, die den DWORD-WertSystemRestorePointCreationFrequency unter dem Registrierungsschlüssel HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore erstellen. Der Wert dieses Registrierungsschlüssels kann die Häufigkeit der Erstellung des Wiederherstellungspunkts ändern. Der Wert dieses Registrierungsschlüssels kann die Häufigkeit der Erstellung des Wiederherstellungspunkts ändern.

Wenn die Anwendung CreateRestorePoint aufruft, um einen Wiederherstellungspunkt zu erstellen, und der Registrierungsschlüsselwert 0 ist, überspringt die Systemwiederherstellung das Erstellen des neuen Wiederherstellungspunkts nicht.

Wenn die Anwendung CreateRestorePoint aufruft, um einen Wiederherstellungspunkt zu erstellen, und der Registrierungsschlüsselwert die ganze Zahl N ist, überspringt die Systemwiederherstellung die Erstellung eines neuen Wiederherstellungspunkts, wenn in den vorherigen N Minuten Wiederherstellungspunkte erstellt wurden.

Beispiele

'CreateRestorePoint Method of the SystemRestore Class
'Creates a restore point. Specifies the beginning and 
'the ending of a set of changes so that System Restore 
'can create a restore point.This method is the 
'scriptable equivalent of the SRSetRestorePoint function.

Set Args = wscript.Arguments
If Args.Count() > 0 Then
    RpName = Args.item(0)
Else 
    RpName = "Vbscript"
End If

Set obj = GetObject("winmgmts:{impersonationLevel=impersonate}!root/default:SystemRestore")

If (obj.CreateRestorePoint(RpName, 0, 100)) = 0 Then
    wscript.Echo "Success"
Else 
    wscript.Echo "Failed"
End If

Anforderungen

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

Siehe auch

SystemRestore

Freigeben über