Metode IVssFileShareSnapshotProvider::D eleteSnapshots (vsprov.h)

  • Artikel

Menghapus rekam jepret tertentu, atau semua rekam jepret dalam set rekam jepret tertentu.

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

Koordinator VSS memanggil metode ini sebagai bagian dari proses rilis otomatis rekam jepret. Metode ini juga dipanggil sebagai respons terhadap operasi penghapusan yang didorong pemohon.

Persyaratan

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

Lihat juga

IVssFileShareSnapshotProvider