Метод CreateRestorePoint класса SystemRestore

Статья
06/13/2023

Создает точку восстановления.

Этот метод является скриптируемым эквивалентом функции SRSetRestorePoint .

Синтаксис

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

Параметры

Описание [в]

Описание, отображаемое для того, чтобы пользователь легко идентифицировать точку восстановления. Максимальная длина строки ANSI составляет MAX_DESC. Максимальная длина строки Юникода MAX_DESC_W. Дополнительные сведения см. в разделе Текст описания точки восстановления.

RestorePointType [in]

Тип точки восстановления. Этот элемент может быть одним из следующих значений.

Тип точки восстановления	Значение
APPLICATION_INSTALL 0	Приложение установлено.
APPLICATION_UNINSTALL 1	Приложение удалено.
DEVICE_DRIVER_INSTALL 10	Установлен драйвер устройства.
MODIFY_SETTINGS 12	В приложении добавлены или удалены функции.
CANCELLED_OPERATION 13	Приложению необходимо удалить созданную точку восстановления. Например, приложение будет использовать этот флаг, когда пользователь отменяет установку.

EventType [in]

Тип события. Этот элемент может быть одним из следующих значений.

Тип события	Значение
BEGIN_NESTED_SYSTEM_CHANGE 102	Системные изменения начались. Последующий вложенный вызов не создает новую точку восстановления. Последующие вызовы должны использовать END_NESTED_SYSTEM_CHANGE, а не END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE 100	Системные изменения начались. Последующий вызов должен использовать END_SYSTEM_CHANGE, а не END_NESTED_SYSTEM_CHANGE.
END_NESTED_SYSTEM_CHANGE 103	Системное изменение завершено.
END_SYSTEM_CHANGE 101	Системное изменение завершено.

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h.

Приложения должны создать этот ключ, чтобы использовать его, так как он не будет существовать в системе. Следующие действия будут применяться по умолчанию, если ключ не существует. Если приложение вызывает метод CreateRestorePoint для создания точки восстановления, Windows пропускает создание этой новой точки восстановления, если за последние 24 часа были созданы какие-либо точки восстановления. Метод CreateRestorePoint возвращает S_OK.

Разработчики могут создавать приложения, создающие значение DWORDSystemRestorePointCreationFrequency в разделе реестра HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore. Значение этого раздела реестра может изменить частоту создания точек восстановления. Значение этого раздела реестра может изменить частоту создания точек восстановления.

Если приложение вызывает CreateRestorePoint для создания точки восстановления и значение раздела реестра равно 0, восстановление системы не пропускает создание новой точки восстановления.

Если приложение вызывает CreateRestorePoint для создания точки восстановления и значением раздела реестра является целое число N, восстановление системы пропускает создание новой точки восстановления, если какие-либо точки восстановления были созданы за предыдущие N минут.

Примеры

'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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Ни одна версия не поддерживается
Пространство имен	Root\Default
MOF	Sr.mof

См. также раздел

SystemRestore