Metode IVssProviderCreateSnapshotSet::AbortSnapshots (vsprov.h)

  • Artikel

Metode AbortSnapshots membatalkan salinan bayangan yang disiapkan di penyedia ini. Ini termasuk semua salinan bayangan yang tidak berkomitmen dan salinan bayangan yang telah dilakukan sebelumnya.

Sintaks

HRESULT AbortSnapshots(
  [in] VSS_ID SnapshotSetId
);

Parameter

[in] SnapshotSetId

VSS_ID yang mengidentifikasi kumpulan salinan bayangan.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai Deskripsi
S_OK
0x00000000L
 Operasi berhasil diselesaikan.
E_OUTOFMEMORY
0x8007000EL
 Kehabisan memori atau sumber daya sistem lainnya.
E_INVALIDARG
0x80070057L
 Salah satu nilai parameter tidak valid.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 Parameter SnapshotSetId mengacu pada objek yang tidak ditemukan.
VSS_E_PROVIDER_VETO
0x80042306L
 Terjadi kesalahan penyedia tak terduga. Penyedia harus mencatat pesan dalam log peristiwa aplikasi yang memberi pengguna informasi tentang cara mengatasi masalah.

Keterangan

VSS hanya akan memanggil AbortSnapshots setelah pemohon memanggil IVssBackupComponents::D oSnapshotSet, bahkan jika salinan bayangan gagal atau dibatalkan sebelum titik ini. Ini berarti bahwa penyedia tidak akan menerima panggilan AbortSnapshots sampai setelah EndPrepareSnapshots dipanggil. Jika salinan bayangan dibatalkan atau gagal sebelum titik ini, penyedia tidak diberi indikasi apa pun sampai salinan bayangan baru dimulai. Untuk alasan ini, penyedia harus siap untuk menangani panggilan IVssHardwareSnapshotProvider::BeginPrepareSnapshot di luar urutan kapan saja. Panggilan di luar urutan ini mewakili awal urutan pembuatan salinan bayangan baru dan akan memiliki ID set salinan bayangan baru.

Persyaratan

   
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

Lihat juga

IVssProviderCreateSnapshotSet