Metode IVssBackupComponents::D oSnapshotSet (vsbackup.h)

Artikel
03/08/2023

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.

Nilai kembali

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

Persyaratan	Nilai
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