Metodo CreateRestorePoint della classe SystemRestore

Articolo
06/13/2023

Crea un punto di ripristino.

Questo metodo è l'equivalente scriptabile della funzione SRSetRestorePoint .

Sintassi

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

Parametri

Descrizione [in]

La descrizione da visualizzare in modo che l'utente possa identificare facilmente un punto di ripristino. La lunghezza massima di una stringa ANSI è MAX_DESC. La lunghezza massima di una stringa Unicode è MAX_DESC_W. Per altre informazioni, vedere Testo Descrizione punto di ripristino.

RestorePointType [in]

Tipo di punto di ripristino. Questo membro può essere uno dei valori seguenti.

Tipo di punto di ripristino	Significato
APPLICATION_INSTALL 0	È stata installata un'applicazione.
APPLICATION_UNINSTALL 1	È stata disinstallata un'applicazione.
DEVICE_DRIVER_INSTALL 10	È stato installato un driver di dispositivo.
MODIFY_SETTINGS 12	Un'applicazione ha avuto funzionalità aggiunte o rimosse.
CANCELLED_OPERATION 13	Un'applicazione deve eliminare il punto di ripristino creato. Ad esempio, un'applicazione userebbe questo flag quando un utente annulla un'installazione.

EventType [in]

Tipo di evento. Questo membro può essere uno dei valori seguenti.

Tipo di evento	Significato
BEGIN_NESTED_SYSTEM_CHANGE 102	È iniziata una modifica del sistema. Una chiamata annidata successiva non crea un nuovo punto di ripristino. Le chiamate successive devono usare END_NESTED_SYSTEM_CHANGE, non END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE 100	È iniziata una modifica del sistema. Una chiamata successiva deve usare END_SYSTEM_CHANGE, non END_NESTED_SYSTEM_CHANGE.
END_NESTED_SYSTEM_CHANGE 103	È stata terminata una modifica di sistema.
END_SYSTEM_CHANGE 101	È stata terminata una modifica di sistema.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il metodo restituisce uno dei codici di errore COM definiti in WinError.h.

Commenti

**Windows 8: **

Una nuova chiave del Registro di sistema consente agli sviluppatori di applicazioni di modificare la frequenza di creazione del punto di ripristino.

Le applicazioni devono creare questa chiave da usare perché non saranno preesistenti nel sistema. Il codice seguente verrà applicato per impostazione predefinita se la chiave non esiste. Se un'applicazione chiama il metodo CreateRestorePoint per creare un punto di ripristino, Windows ignora la creazione di questo nuovo punto di ripristino se gli eventuali punti di ripristino sono stati creati negli ultimi 24 ore. Il metodo CreateRestorePoint restituisce S_OK.

Gli sviluppatori possono scrivere applicazioni che creano il valore DWORDSystemRestorePointCreationFrequency nella chiave del Registro di sistema HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore. Il valore di questa chiave del Registro di sistema può modificare la frequenza di creazione del punto di ripristino. Il valore di questa chiave del Registro di sistema può modificare la frequenza di creazione del punto di ripristino.

Se l'applicazione chiama CreateRestorePoint per creare un punto di ripristino e il valore della chiave del Registro di sistema è 0, il ripristino di sistema non ignora la creazione del nuovo punto di ripristino.

Se l'applicazione chiama CreateRestorePoint per creare un punto di ripristino e il valore della chiave del Registro di sistema è l'intero N, il ripristino di sistema ignora la creazione di un nuovo punto di ripristino se i punti di ripristino sono stati creati nei minuti N precedenti.

Esempio

'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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Nessuno supportato
Spazio dei nomi	Radice\Impostazione predefinita
MOF	Sr.mof

Vedi anche

SystemRestore

Condividi tramite