SystemRestore class

Provides methods for disabling and enabling monitoring, listing available restore points, and initiating a restore on the local system.

Syntax

class SystemRestore
{
  String Description;
  uint32 RestorePointType;
  uint32 EventType;
  uint32 SequenceNumber;
  String CreationTime;
};

Members

The SystemRestore class has these types of members:

Methods

The SystemRestore class has these methods.

Method Description
CreateRestorePoint Creates a restore point.
Disable Disables monitoring on a particular drive.
Enable Enables monitoring on a particular drive.
GetLastRestoreStatus Retrieves the status of the last system restore.
Restore Initiates a system restore.

Properties

The SystemRestore class has these properties.

CreationTime

Data type: String

Access type: Read/write

The time at which the state change occurred.

Description

Data type: String

Access type: Read/write

The description to be displayed so the user can easily identify a restore point. The maximum length of an ANSI string is MAX_DESC. The maximum length of a Unicode string is MAX_DESC_W. For more information, see Restore Point Description Text.

EventType

Data type: uint32

Access type: Read/write

The type of event. This member can be one of the following values.

Value Meaning
BEGIN_NESTED_SYSTEM_CHANGE
102
A system change has begun. A subsequent nested call does not create a new restore point.
Subsequent calls must use END_NESTED_SYSTEM_CHANGE, not END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE
100
A system change has begun.
END_NESTED_SYSTEM_CHANGE
103
A system change has ended.
END_SYSTEM_CHANGE
101
A system change has ended.

RestorePointType

Data type: uint32

Access type: Read/write

The type of restore point. This member can be one of the following values.

Value Meaning
APPLICATION_INSTALL
0
An application has been installed.
APPLICATION_UNINSTALL
1
An application has been uninstalled.
CANCELLED_OPERATION
13
An application needs to delete the restore point it created. For example, an application would use this flag when a user cancels an installation.
DEVICE_DRIVER_INSTALL
10
A device driver has been installed.
MODIFY_SETTINGS
12
An application has had features added or removed.

SequenceNumber

Data type: uint32

Access type: Read/write

Qualifiers: Key

The sequence number of the restore point.

Remarks

You can obtain a list of restore points by using the SWbemServices.InstancesOf method to retrieve a collection of SystemRestore objects. You can use the class properties to identify the restore point.

Examples

The following sample script enumerates the current restore points.

'SystemRestore Class
'Provides methods for disabling and enabling monitoring, 
'listing available restore points, and initiating a 
'restore on the local system.

Set RPSet = GetObject("winmgmts:root/default").InstancesOf ("SystemRestore")
for each RP in RPSet
    wscript.Echo "Dir: RP" & RP.SequenceNumber & ", Name: " & RP.Description & ", Type: ", RP.RestorePointType & ", Time: " & RP.CreationTime
next

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
None supported
Namespace
Root\Default
MOF
Sr.mof

See also

Windows Management Instrumentation