Metode IVssSoftwareSnapshotProvider::D eleteSnapshots (vsprov.h)

  • Artikel

Menghapus satu atau beberapa salinan bayangan atau set 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 yang akan dihapus. Nilai parameter ini VSS_OBJECT_SNAPSHOT atau VSS_OBJECT_SNAPSHOT_SET.

[in] bForceDelete

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

[out] plDeletedSnapshots

Penunjuk ke variabel yang menerima jumlah salinan bayangan yang dihapus.

[out] pNondeletedSnapshotID

Jika terjadi kesalahan, parameter ini menerima penunjuk ke pengidentifikasi salinan bayangan pertama yang tidak dapat dihapus. Jika tidak, itu menunjuk ke 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 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_OBJECT_NOT_FOUND
 Salinan bayangan yang ditentukan tidak ditemukan.
VSS_E_PROVIDER_VETO
 Kesalahan penyedia. Penyedia mencatat kesalahan dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Keterangan

Beberapa salinan bayangan dalam set 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.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header vsprov.h
Pustaka VssApi.lib

Lihat juga

IVssSoftwareSnapshotProvider