SystemRestore 클래스의 CreateRestorePoint 메서드

복원 지점을 만듭니다.

이 메서드는 SRSetRestorePoint 함수에 해당하는 스크립트 가능 메서드입니다.

구문

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

매개 변수

설명 [in]

사용자가 복원 지점을 쉽게 식별할 수 있도록 표시할 설명입니다. 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_SYSTEM_CHANGE 아닌 END_NESTED_SYSTEM_CHANGE 사용해야 합니다.
BEGIN_SYSTEM_CHANGE 100	시스템 변경이 시작되었습니다. 후속 호출은 END_NESTED_SYSTEM_CHANGE 아닌 END_SYSTEM_CHANGE 사용해야 합니다.
END_NESTED_SYSTEM_CHANGE 103	시스템 변경이 종료되었습니다.
END_SYSTEM_CHANGE 101	시스템 변경이 종료되었습니다.

반환 값

메서드가 성공하면 반환 값이 S_OK. 그렇지 않으면 메서드는 WinError.h에 정의된 COM 오류 코드 중 하나를 반환합니다.

설명

**Windows 8: **

새 레지스트리 키를 사용하면 애플리케이션 개발자가 복원 지점 생성 빈도를 변경할 수 있습니다.

애플리케이션은 시스템에서 기존 키가 아니므로 이를 사용하기 위해 이 키를 만들어야 합니다. 키가 없는 경우 기본적으로 다음이 적용됩니다. 애플리케이션이 CreateRestorePoint 메서드를 호출하여 복원 지점을 만드는 경우 Windows는 지난 24시간 동안 복원 지점을 만든 경우 이 새 복원 지점 만들기를 건너뜁니다. CreateRestorePoint 메서드는 S_OK 반환합니다.

개발자는 레지스트리 키 HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore 아래에 DWORD 값 SystemRestorePointCreationFrequency를 만드는 애플리케이션을 작성할 수 있습니다. 이 레지스트리 키의 값은 복원 지점 생성 빈도를 변경할 수 있습니다. 이 레지스트리 키의 값은 복원 지점 생성 빈도를 변경할 수 있습니다.

애플리케이션이 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

요구 사항

추가 정보

SystemRestore