SystemRestore 類別的 CreateRestorePoint 方法

建立還原點。

這個方法相當於 SRSetRestorePoint 函式的可編寫腳本。

語法

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

參數

描述 [in]

要顯示的描述，讓使用者可以輕鬆地識別還原點。 ANSI 字串的最大長度為 MAX_DESC。 Unicode 字串的最大長度為 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。 否則，方法會傳回 WinError.h 中定義的其中一個 COM 錯誤碼。

備註

**Windows 8： **

新的登錄機碼可讓應用程式開發人員變更還原點建立的頻率。

應用程式應該建立此金鑰以使用它，因為它不會存在於系統中。 如果索引鍵不存在，則預設會套用下列專案。 如果應用程式呼叫 CreateRestorePoint 方法來建立還原點，如果過去 24 小時內已建立任何還原點，Windows 會略過建立這個新的還原點。 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