Metode IVssBackupComponentsEx2::BreakSnapshotSetEx (vsbackup.h)

  • Artikel

Memutus set salinan bayangan sesuai dengan opsi yang ditentukan pemohon.

Sintaks

HRESULT BreakSnapshotSetEx(
  [in]  VSS_ID    SnapshotSetID,
  [in]  DWORD     dwBreakFlags,
  [out] IVssAsync **ppAsync
);

Parameter

[in] SnapshotSetID

Pengidentifikasi set salinan bayangan.

[in] dwBreakFlags

Bitmask bendera _VSS_HARDWARE_OPTIONS yang menentukan bagaimana kumpulan salinan bayangan rusak.

[out] ppAsync

Penunjuk ke variabel yang menerima penunjuk antarmuka IVssAsync yang dapat digunakan untuk mengambil status operasi pemutusan set salinan bayangan. Ketika operasi pemutusan selesai, metode IUnknown::Release harus dipanggil untuk penunjuk antarmuka ini.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
0x00000000L
 Set salinan bayangan berhasil rusak.
E_ACCESSDENIED
0x80070005L
 Pemanggil tidak memiliki hak istimewa yang memadai atau bukan administrator.
E_INVALIDARG
0x80070057L
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
0x8007000EL
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BREAK_REVERT_ID_FAILED
0x800423F6L
 Operasi pemutusan set salinan bayangan gagal karena tanda tangan disk MBR, pengidentifikasi disk GPT, atau pengidentifikasi partisi GPT dari satu atau beberapa LUN tujuan tidak dapat dikembalikan ke LUN asli. Jika satu atau beberapa LUN asli tidak ditutupi di komputer, operasi pemutusan akan menyebabkan tabrakan tanda tangan.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 Salinan bayangan yang ditentukan tidak ada.
VSS_E_PROVIDER_VETO
0x80042306L
 Salinan bayangan dibuat oleh penyedia perangkat lunak dan tidak dapat dipecah.
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.

Keterangan

BreakSnapshotSetEx mirip dengan metode IVssBackupComponents::BreakSnapshotSet , kecuali bahwa ia memiliki parameter tambahan untuk status kueri dan menentukan bagaimana kumpulan salinan bayangan rusak.

Seperti BreakSnapshotSet, BreakSnapshotSetEx hanya dapat digunakan untuk salinan bayangan yang dibuat oleh penyedia salinan bayangan perangkat keras.

Setelah metode ini kembali, volume salinan bayangan masih merupakan volume, tetapi bukan lagi salinan bayangan. Untuk informasi selengkapnya, lihat Memutus Salinan Bayangan.

Persyaratan

   
Klien minimum yang didukung Windows Vista dengan SP1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)