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 |
|