Méthode CreateRestorePoint de la classe SystemRestore

Crée un point de restauration.

Cette méthode est l’équivalent scriptable de la fonction SRSetRestorePoint .

Syntaxe

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

Paramètres

Description [ dans]

Description à afficher pour permettre à l’utilisateur d’identifier facilement un point de restauration. La longueur maximale d’une chaîne ANSI est la valeur _ desc max. La longueur maximale d’une chaîne Unicode est le nombre maximal de _ desc _ W. Pour plus d’informations, consultez texte de description du point de restauration.

RestorePointType [ dans]

Type de point de restauration. Ce membre peut être l’une des valeurs suivantes.

Type de point de restauration Signification
Application _ INSTALLER
0
Une application a été installée.
Application _ Désinstaller
1
Une application a été désinstallée.
Appareil mobile _ _Installation du pilote
10
Un pilote de périphérique a été installé.
Modifier _ PARAMÈTRES
12
Des fonctionnalités ont été ajoutées ou supprimées pour une application.
Annulé _ OPÉRATION
13
Une application doit supprimer le point de restauration créé. Par exemple, une application utilise cet indicateur lorsqu’un utilisateur annule une installation.

EventType [ dans]

Type de l'événement. Ce membre peut être l’une des valeurs suivantes.

Type d'événement Signification
Commencer _ _ _ Modification système imbriquée
102
Une modification du système a commencé. Un appel imbriqué suivant ne crée pas de nouveau point de restauration.
Les appels suivants doivent utiliser la fin du _ _ _ changement de système imbriqué, pas la modification du système de fin _ _ .
Commencer _ _Modification système
100
Une modification du système a commencé.
Un appel suivant doit utiliser la _ modification du système _ de fin, et non une _ modification du système imbriquée _ _ .
Fin _ _ _ Modification système imbriquée
103
Une modification du système s’est terminée.
Fin _ _Modification système
101
Une modification du système s’est terminée.

Valeur retournée

Si la méthode est réussie, la valeur de retour est S _ OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError. h.

Notes

    • Windows 8 : * *

Une nouvelle clé de registre permet aux développeurs d’applications de modifier la fréquence de création du point de restauration.

Les applications doivent créer cette clé pour l’utiliser, car elle n’est pas préexistante dans le système. Les éléments suivants s’appliquent par défaut si la clé n’existe pas. Si une application appelle la méthode CreateRestorePoint pour créer un point de restauration, Windows ignore la création de ce nouveau point de restauration si des points de restauration ont été créés au cours des dernières 24 heures. La méthode CreateRestorePoint retourne S _ OK.

Les développeurs peuvent écrire des applications qui créent la valeur DWORD SystemRestorePointCreationFrequency sous la clé de Registre HKLM \ Software \ Microsoft \ Windows NT \ CurrentVersion \ SystemRestore. La valeur de cette clé de Registre peut modifier la fréquence de création du point de restauration. La valeur de cette clé de Registre peut modifier la fréquence de création du point de restauration.

Si l’application appelle CreateRestorePoint pour créer un point de restauration et que la valeur de la clé de Registre est 0, la restauration du système n’ignore pas la création du nouveau point de restauration.

Si l’application appelle CreateRestorePoint pour créer un point de restauration et que la valeur de la clé de Registre est l’entier N, la restauration du système ignore la création d’un nouveau point de restauration si des points de restauration ont été créés au cours des N minutes précédentes.

Exemples

'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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Applications de [ Bureau Windows XP uniquement]
Serveur minimal pris en charge
Aucun pris en charge
Espace de noms
Racine \ par défaut
MOF
SR. mof

Voir aussi

SystemRestore