Metode IVssBackupComponents::D eleteSnapshots (vsbackup.h)

Artikel
08/27/2023

Metode DeleteSnapshots menghapus satu atau beberapa salinan bayangan atau kumpulan salinan bayangan.

Sintaks

HRESULT DeleteSnapshots(
  [in]  VSS_ID          SourceObjectId,
  [in]  VSS_OBJECT_TYPE eSourceObjectType,
  [in]  BOOL            bForceDelete,
  [out] LONG            *plDeletedSnapshots,
  [out] VSS_ID          *pNondeletedSnapshotID
);

Parameter

[in] SourceObjectId

Pengidentifikasi salinan bayangan atau salinan bayangan yang diatur untuk dihapus.

[in] eSourceObjectType

Tipe objek tempat semua salinan bayangan akan dihapus. Nilai parameter ini VSS_OBJECT_SNAPSHOT atau VSS_OBJECT_SNAPSHOT_SET.

[in] bForceDelete

Jika nilai parameter ini TRUE, penyedia akan melakukan semua yang mungkin untuk menghapus salinan bayangan atau salinan bayangan dalam set salinan bayangan. Jika false, tidak ada upaya tambahan yang akan dilakukan.

[out] plDeletedSnapshots

Jumlah salinan bayangan yang dihapus.

[out] pNondeletedSnapshotID

Jika terjadi kesalahan, nilai parameter ini adalah pengidentifikasi salinan bayangan pertama yang tidak dapat dihapus. Jika tidak, itu GUID_NULL.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Salinan bayangan berhasil dihapus.
E_ACCESSDENIED	Pemanggil tidak memiliki hak istimewa pencadangan yang memadai atau bukan administrator.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_UNEXPECTED	Kesalahan tak terduga. Kode kesalahan dicatat dalam file log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008 R2 dan Windows 7. E_UNEXPECTED digunakan sebagai gantinya.
VSS_E_OBJECT_NOT_FOUND	Salinan bayangan yang ditentukan tidak ada.
VSS_E_PROVIDER_VETO	Kesalahan penyedia yang diharapkan. Penyedia mencatat kesalahan dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Kesalahan penyedia tak terduga. Kode kesalahan dicatat dalam log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Keterangan

Beberapa salinan bayangan dalam kumpulan salinan bayangan dihapus secara berurutan. Jika terjadi kesalahan selama salah satu penghapusan individu ini, DeleteSnapshots akan segera kembali; tidak ada upaya yang akan dilakukan untuk menghapus salinan bayangan yang tersisa. VSS_ID salinan bayangan yang tidak dihapus dikembalikan dalam pNondeletedSnapshotID.

Pemohon bertanggung jawab untuk membuat serialisasi operasi hapus salinan bayangan.

Selama pencadangan, salinan bayangan secara otomatis dirilis segera setelah instans IVssBackupComponents dirilis. Dalam hal ini, tidak perlu menghapus salinan bayangan secara eksplisit.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)
Pustaka	VssApi.lib

Lihat juga

IVssBackupComponents

IVssBackupComponents::StartSnapshotSet

VSS_ID

Bagikan melalui