Compartir a través de

Método CreateRestorePoint de la clase SystemRestore

  • Artículo

Crea un punto de restauración.

Este método es el equivalente que se puede incluir en scripts de la función SRSetRestorePoint .

Sintaxis

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

Parámetros

Descripción [in]

Descripción que se va a mostrar para que el usuario pueda identificar fácilmente un punto de restauración. La longitud máxima de una cadena ANSI es MAX_DESC. La longitud máxima de una cadena Unicode es MAX_DESC_W. Para obtener más información, vea Texto de descripción del punto de restauración.

RestorePointType [in]

Tipo de punto de restauración. Este miembro puede ser uno de los valores siguientes.

Tipo de punto de restauración Significado
APPLICATION_INSTALL
0
 Se ha instalado una aplicación.
APPLICATION_UNINSTALL
1
 Se ha desinstalado una aplicación.
DEVICE_DRIVER_INSTALL
10
 Se ha instalado un controlador de dispositivo.
MODIFY_SETTINGS
12
 Una aplicación ha agregado o quitado características.
CANCELLED_OPERATION
13
 Una aplicación debe eliminar el punto de restauración que creó. Por ejemplo, una aplicación usaría esta marca cuando un usuario cancela una instalación.

EventType [in]

Tipo del evento. Este miembro puede ser uno de los valores siguientes.

Tipo de evento Significado
BEGIN_NESTED_SYSTEM_CHANGE
102
 Se ha iniciado un cambio del sistema. Una llamada anidada posterior no crea un nuevo punto de restauración.
Las llamadas posteriores deben usar END_NESTED_SYSTEM_CHANGE, no END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE
100
 Se ha iniciado un cambio del sistema.
Una llamada posterior debe usar END_SYSTEM_CHANGE, no END_NESTED_SYSTEM_CHANGE.
END_NESTED_SYSTEM_CHANGE
103
 Ha finalizado un cambio del sistema.
END_SYSTEM_CHANGE
101
 Ha finalizado un cambio del sistema.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en WinError.h.

Comentarios

**Windows 8: **

Una nueva clave del Registro permite a los desarrolladores de aplicaciones cambiar la frecuencia de creación de puntos de restauración.

Las aplicaciones deben crear esta clave para usarla porque no se producirán previamente en el sistema. De forma predeterminada, se aplicará lo siguiente si la clave no existe. Si una aplicación llama al método CreateRestorePoint para crear un punto de restauración, Windows omite la creación de este nuevo punto de restauración si se han creado puntos de restauración en las últimas 24 horas. El método CreateRestorePoint devuelve S_OK.

Los desarrolladores pueden escribir aplicaciones que creen el valor DWORDSystemRestorePointCreationFrequency en la clave del Registro HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore. El valor de esta clave del Registro puede cambiar la frecuencia de creación de puntos de restauración. El valor de esta clave del Registro puede cambiar la frecuencia de creación de puntos de restauración.

Si la aplicación llama a CreateRestorePoint para crear un punto de restauración y el valor de la clave del Registro es 0, la restauración del sistema no omite la creación del nuevo punto de restauración.

Si la aplicación llama a CreateRestorePoint para crear un punto de restauración y el valor de la clave del Registro es el entero N, la restauración del sistema omite la creación de un nuevo punto de restauración si se crearon puntos de restauración en los N minutos anteriores.

Ejemplos

'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

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Espacio de nombres
 Root\Default
MOF
Sr.mof

Consulte también

SystemRestore