Metode CreateRestorePoint dari kelas SystemRestore

Artikel
06/13/2023

Membuat titik pemulihan.

Metode ini setara dengan fungsi SRSetRestorePoint yang dapat ditulis.

Sintaks

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

Parameter

Deskripsi [in]

Deskripsi yang akan ditampilkan sehingga pengguna dapat dengan mudah mengidentifikasi titik pemulihan. Panjang maksimum string ANSI adalah MAX_DESC. Panjang maksimum untai (karakter) Unicode adalah MAX_DESC_W. Untuk informasi selengkapnya, lihat Teks Deskripsi Titik Pemulihan.

RestorePointType [in]

Jenis titik pemulihan. Anggota ini bisa menjadi salah satu nilai berikut.

Jenis titik pemulihan	Makna
APPLICATION_INSTALL 0	Aplikasi telah diinstal.
APPLICATION_UNINSTALL 1	Aplikasi telah dihapus instalasinya.
DEVICE_DRIVER_INSTALL 10	Pengandar perangkat telah diinstal.
MODIFY_SETTINGS 12	Aplikasi telah menambahkan atau menghapus fitur.
CANCELLED_OPERATION 13	Aplikasi perlu menghapus titik pemulihan yang dibuatnya. Misalnya, aplikasi akan menggunakan bendera ini saat pengguna membatalkan penginstalan.

EventType [in]

Jenis kejadian. Anggota ini bisa menjadi salah satu nilai berikut.

Jenis peristiwa	Makna
BEGIN_NESTED_SYSTEM_CHANGE 102	Perubahan sistem telah dimulai. Panggilan berlapis berikutnya tidak membuat titik pemulihan baru. Panggilan berikutnya harus menggunakan END_NESTED_SYSTEM_CHANGE, bukan END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE 100	Perubahan sistem telah dimulai. Panggilan berikutnya harus menggunakan END_SYSTEM_CHANGE, bukan END_NESTED_SYSTEM_CHANGE.
END_NESTED_SYSTEM_CHANGE 103	Perubahan sistem telah berakhir.
END_SYSTEM_CHANGE 101	Perubahan sistem telah berakhir.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, metode mengembalikan salah satu kode kesalahan COM yang ditentukan dalam WinError.h.

Keterangan

**Windows 8: **

Kunci registri baru memungkinkan pengembang aplikasi mengubah frekuensi pembuatan titik pemulihan.

Aplikasi harus membuat kunci ini untuk menggunakannya karena tidak akan ada sebelumnya dalam sistem. Berikut ini akan berlaku secara default jika kunci tidak ada. Jika aplikasi memanggil metode CreateRestorePoint untuk membuat titik pemulihan, Windows melompati pembuatan titik pemulihan baru ini jika ada titik pemulihan yang telah dibuat dalam 24 jam terakhir. Metode CreateRestorePoint mengembalikan S_OK.

Pengembang dapat menulis aplikasi yang membuat nilai DWORDSystemRestorePointCreationFrequency di bawah kunci registri HKLM\Software\Microsoft\Windows NT\CurrentVersion\SystemRestore. Nilai kunci registri ini dapat mengubah frekuensi pembuatan titik pemulihan. Nilai kunci registri ini dapat mengubah frekuensi pembuatan titik pemulihan.

Jika aplikasi memanggil CreateRestorePoint untuk membuat titik pemulihan, dan nilai kunci registri adalah 0, pemulihan sistem tidak melewati pembuatan titik pemulihan baru.

Jika aplikasi memanggil CreateRestorePoint untuk membuat titik pemulihan, dan nilai kunci registri adalah bilangan bulat N, pemulihan sistem melompati pembuatan titik pemulihan baru jika ada titik pemulihan yang dibuat di N menit sebelumnya.

Contoh

'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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Ruang nama	Root\Default
MOF	Sr.mof

Lihat juga

SystemRestore

Bagikan melalui