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 [in]

Description à afficher afin que l’utilisateur puisse facilement identifier un point de restauration. La longueur maximale d’une chaîne ANSI est MAX_DESC. La longueur maximale d’une chaîne Unicode est MAX_DESC_W. Pour plus d’informations, consultez Texte de description du point de restauration.

RestorePointType [in]

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

Type de point de restauration	Signification
APPLICATION_INSTALL 0	Une application a été installée.
APPLICATION_UNINSTALL 1	Une application a été désinstallée.
DEVICE_DRIVER_INSTALL 10	Un pilote de périphérique a été installé.
MODIFY_SETTINGS 12	Des fonctionnalités ont été ajoutées ou supprimées pour une application.
CANCELLED_OPERATION 13	Une application doit supprimer le point de restauration qu’elle a créé. Par exemple, une application utilise cet indicateur lorsqu’un utilisateur annule une installation.

EventType [in]

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

Type d'événement	Signification
BEGIN_NESTED_SYSTEM_CHANGE 102	Une modification du système a commencé. Un appel imbriqué suivant ne crée pas de point de restauration. Les appels suivants doivent utiliser END_NESTED_SYSTEM_CHANGE et non END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE 100	Une modification du système a commencé. Un appel suivant doit utiliser END_SYSTEM_CHANGE et non END_NESTED_SYSTEM_CHANGE.
END_NESTED_SYSTEM_CHANGE 103	Une modification du système a pris fin.
END_SYSTEM_CHANGE 101	Une modification du système a pris fin.

Valeur retournée

Si la méthode réussit, 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’existera pas 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 DWORDSystemRestorePointCreationFrequency 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 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

Spécifications

Voir aussi

SystemRestore