Metode IVssBackupComponents::D oSnapshotSet (vsbackup.h)

Menerapkan semua salinan bayangan dalam set ini secara bersamaan.

Sintaks

HRESULT DoSnapshotSet(
  [out] IVssAsync **ppAsync
);

Parameter

[out] ppAsync

Penunjuk tidak langsung dua kali lipat ke antarmuka asinkron IVssAsync yang diperlukan. Ini digunakan untuk mengkueri status eksekusi metode dan untuk mengambil kode kesalahan akhir.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini. Kode kesalahan ini dapat dikembalikan dari metode ini, atau dari metode QueryStatus pada antarmuka IVssAsync yang dikembalikan dalam parameter ppAsync .

Nilai Makna
S_OK
Berhasil mengembalikan pointer ke instans antarmuka IVssAsync . Lihat IVssAsync::QueryStatus untuk nilai valid yang dikembalikan oleh parameter pHrResult .
E_ACCESSDENIED
Pemanggil tidak memiliki hak pencadangan yang memadai atau bukan administrator.
E_INVALIDARG
ppAsync tidak menunjuk ke penunjuk yang valid; artinya, itu ADALAH NULL.
E_OUTOFMEMORY
Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE
Objek komponen cadangan belum diinisialisasi atau panggilan prasyarat untuk konteks salinan bayangan tertentu belum dilakukan sebelum memanggil DoSnapshotSet.
VSS_E_INSUFFICIENT_STORAGE
Sistem atau penyedia memiliki ruang penyimpanan yang tidak memadai. Jika memungkinkan, hapus salinan bayangan persisten lama atau yang tidak perlu, lalu coba lagi. Kode kesalahan ini hanya dikembalikan melalui metode QueryStatus pada antarmuka IVssAsync yang dikembalikan dalam parameter ppAsync .
VSS_E_FLUSH_WRITES_TIMEOUT
Sistem tidak dapat membersihkan tulisan I/O. Ini bisa menjadi masalah sementara. Disarankan untuk menunggu sepuluh menit dan mencoba lagi, hingga tiga kali.
VSS_E_HOLD_WRITES_TIMEOUT
Sistem tidak dapat menahan penulisan I/O. Ini bisa menjadi masalah sementara. Disarankan untuk menunggu sepuluh menit dan mencoba lagi, hingga tiga kali.
VSS_E_NESTED_VOLUME_LIMIT
Volume yang ditentukan ditumpuk terlalu dalam untuk berpartisipasi dalam operasi VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Kode pengembalian ini tidak didukung.

VSS_E_PROVIDER_VETO
Penyedia tidak dapat melakukan permintaan saat ini. Ini bisa menjadi masalah sementara. Disarankan untuk menunggu sepuluh menit dan mencoba lagi, hingga tiga kali. Kode kesalahan ini hanya dikembalikan melalui metode QueryStatus pada antarmuka IVssAsync yang dikembalikan dalam parameter ppAsync .
VSS_E_REBOOT_REQUIRED
Penyedia mengalami kesalahan yang mengharuskan pengguna untuk menghidupkan ulang komputer.

Windows Server 2003 dan Windows XP: Nilai ini tidak didukung.

VSS_E_TRANSACTION_FREEZE_TIMEOUT
Sistem tidak dapat membekukan Koordinator Transaksi Terdistribusi (DTC) atau Manajer Transaksi Kernel (KTM).

Windows Server 2003 dan Windows XP: Nilai ini tidak didukung.

VSS_E_TRANSACTION_THAW_TIMEOUT
Sistem tidak dapat mencairkan Koordinator Transaksi Terdistribusi (DTC) atau Manajer Transaksi Kernel (KTM).

Windows Server 2003 dan Windows XP: Nilai ini tidak didukung.

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_UNEXPECTED_PROVIDER_ERROR
Penyedia mengembalikan kode kesalahan yang tidak terduga. Ini bisa menjadi masalah sementara. Disarankan untuk menunggu sepuluh menit dan mencoba lagi, hingga tiga kali. Kode kesalahan ini hanya dikembalikan melalui metode QueryStatus pada antarmuka IVssAsync yang dikembalikan dalam parameter ppAsync .

Keterangan

Pemanggil bertanggung jawab untuk merilis antarmuka IVssAsync .

Metode ini tidak dapat dipanggil untuk hard disk virtual (VHD) yang bersarang di dalam VHD lain.

Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: VHD tidak didukung.

Untuk informasi tentang cara menggunakan IVssBackupComponents::D oSnapshotSet untuk membuat salinan bayangan cadangan standar, lihat Gambaran Umum Tugas Pra-Pencadangan dan Pembuatan Salinan Bayangan Sederhana untuk Pencadangan. Untuk informasi tentang bagaimana metode digunakan di bawah konteks VSS yang berbeda, lihat Detail Implementasi untuk Membuat Salinan Bayangan.

Persyaratan

   
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

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::P repareForBackup

IVssBackupComponents::StartSnapshotSet