Compartilhar via


Método CreateRestorePoint da classe SystemRestore

Cria um ponto de restauração.

Esse método é o equivalente a script da função SRSetRestorePoint .

Sintaxe

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

Parâmetros

Descrição [in]

A descrição a ser exibida para que o usuário possa identificar facilmente um ponto de restauração. O comprimento máximo de uma cadeia de caracteres ANSI é MAX_DESC. O comprimento máximo de uma cadeia de caracteres Unicode é MAX_DESC_W. Para obter mais informações, consulte Texto de descrição do ponto de restauração.

RestorePointType [in]

O tipo de ponto de restauração. Esse membro pode ser um dos valores a seguir.

Tipo de ponto de restauração Significado
APPLICATION_INSTALL
0
Um aplicativo foi instalado.
APPLICATION_UNINSTALL
1
Um aplicativo foi desinstalado.
DEVICE_DRIVER_INSTALL
10
Um driver de dispositivo foi instalado.
MODIFY_SETTINGS
12
Um aplicativo teve recursos adicionados ou removidos.
CANCELLED_OPERATION
13
Um aplicativo precisa excluir o ponto de restauração que ele criou. Por exemplo, um aplicativo usaria esse sinalizador quando um usuário cancelasse uma instalação.

EventType [in]

O tipo do evento. Esse membro pode ser um dos valores a seguir.

Tipo de evento Significado
BEGIN_NESTED_SYSTEM_CHANGE
102
Uma alteração no sistema começou. Uma chamada aninhada subsequente não cria um novo ponto de restauração.
As chamadas subsequentes devem usar END_NESTED_SYSTEM_CHANGE, não END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE
100
Uma alteração no sistema começou.
Uma chamada subsequente deve usar END_SYSTEM_CHANGE, não END_NESTED_SYSTEM_CHANGE.
END_NESTED_SYSTEM_CHANGE
103
Uma alteração do sistema terminou.
END_SYSTEM_CHANGE
101
Uma alteração do sistema terminou.

Valor retornado

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.

Comentários

**Windows 8: **

Uma nova chave do Registro permite que os desenvolvedores de aplicativos alterem a frequência de criação do ponto de restauração.

Os aplicativos devem criar essa chave para usá-la porque ela não será preexistentes no sistema. O seguinte será aplicado por padrão se a chave não existir. Se um aplicativo chamar o método CreateRestorePoint para criar um ponto de restauração, o Windows ignorará a criação desse novo ponto de restauração se algum ponto de restauração tiver sido criado nas últimas 24 horas. O método CreateRestorePoint retorna S_OK.

Os desenvolvedores podem escrever aplicativos que criam o valor DWORDSystemRestorePointCreationFrequency na chave do Registro HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore. O valor dessa chave do Registro pode alterar a frequência de criação do ponto de restauração. O valor dessa chave do Registro pode alterar a frequência de criação do ponto de restauração.

Se o aplicativo chamar CreateRestorePoint para criar um ponto de restauração e o valor da chave do Registro for 0, a restauração do sistema não ignorará a criação do novo ponto de restauração.

Se o aplicativo chamar CreateRestorePoint para criar um ponto de restauração e o valor da chave do Registro for o número inteiro N, a restauração do sistema ignorará a criação de um novo ponto de restauração se algum ponto de restauração tiver sido criado nos N minutos anteriores.

Exemplos

'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 Valor
Cliente mínimo com suporte
Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Namespace
Raiz\Padrão
MOF
Sr.mof

Confira também

SystemRestore