2 out of 2 rated this helpful - Rate this topic

SystemRestore class

Applies to: desktop apps only

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

Syntax

Copy

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

Members

The SystemRestore class has these types of members:

Methods
Properties

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.

Copy

'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
Minimum supported server	None supported
Namespace	\\.\Root\Default
MOF	Sr.mof

http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a quicker response using the forums than through the Community Content. For specific help about:
Visual Studio  : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C&
SQL Server     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.sqlserver%2C&
.NET Framework : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
PowerShell     : http://groups.google.com/group/microsoft.public.windows.powershell/topics?pli=1
All Public     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C&

History

10/19/2009
Missing information

10/24/2009
Thomas Lee

How to query the SystemRestore status of a given drive?

I see that we can explicitly Enable or Disable SystemRestore tracking of a driveletter.

But how can we query a driveletter to determine whether SystemRestore is enabled or disabled on that drive at present?

[tfl - 24 10 09] Hi - and thanks for your post. You should post questions like this to the MSDN Forums at http://forums.microsoft.com/msdn or the MSDN Newsgroups at

http://www.microsoft.com/communities/newsgroups/en-us/. You are much more likely get a quicker response using the forums than through the Community Content. For specific help about:
Visual Studio  : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.vstudio%2C&
SQL Server     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.sqlserver%2C&
.NET Framework : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public.dotnet.framework
PowerShell     : http://groups.google.com/group/microsoft.public.windows.powershell/topics?pli=1
All Public     : http://groups.google.com/groups/dir?sel=usenet%3Dmicrosoft.public%2C&