Metode IVssBackupComponents::AddToSnapshotSet (vsbackup.h)
Metode AddToSnapshotSet menambahkan volume asli atau berbagi file jarak jauh asli ke set salinan bayangan.
Sintaks
HRESULT AddToSnapshotSet(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_ID ProviderId,
[out] VSS_ID *pidSnapshot
);
Parameter
[in] pwszVolumeName
String karakter lebar yang dihentikan null yang berisi nama volume atau jalur UNC dari berbagi file jarak jauh yang akan disalin bayangan. Nama atau jalur UNC harus dalam salah satu format berikut dan harus menyertakan garis miring terbalik berikutnya (\):
- Jalur folder yang dipasang, misalnya, Y:\MountX\
- Huruf kandar, misalnya, D:\
- Jalur GUID volume dari formulir \\?\Volume{GUID}\ (di mana GUID mengidentifikasi volume)
- Jalur UNC yang menentukan berbagi file jarak jauh, misalnya, \\Clusterx\Share1\
[in] ProviderId
Penyedia yang akan digunakan. GUID_NULL dapat digunakan, dalam hal ini penyedia default akan digunakan.
[out] pidSnapshot
Pengidentifikasi yang dikembalikan dari salinan bayangan yang ditambahkan.
Nilai kembali
Berikut ini adalah kode pengembalian yang valid untuk metode ini.
Nilai | Makna |
---|---|
|
Berhasil menambahkan volume atau berbagi file jarak jauh ke kumpulan salinan bayangan. |
|
Penelepon tidak memiliki hak istimewa pencadangan yang memadai atau bukan administrator. |
|
Salah satu nilai parameter tidak valid. |
|
Pemanggil kehabisan memori atau sumber daya sistem lainnya. |
|
Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar. |
|
Jumlah maksimum volume atau berbagi file jarak jauh telah ditambahkan ke kumpulan salinan bayangan. Volume yang ditentukan atau berbagi file jarak jauh tidak ditambahkan ke set salinan bayangan. |
|
Volume atau berbagi file jarak jauh telah ditambahkan ke jumlah maksimum set salinan bayangan. Volume yang ditentukan atau berbagi file jarak jauh tidak ditambahkan ke set salinan bayangan. |
|
Volume yang ditentukan ditumpuk terlalu dalam untuk berpartisipasi dalam operasi VSS. Kemungkinan alasan kesalahan ini meliputi hal-hal berikut:
|
|
pwszVolumeName tidak sesuai dengan volume yang ada atau berbagi file jarak jauh. |
|
ProviderId tidak sesuai dengan penyedia terdaftar. |
|
Kesalahan penyedia yang diharapkan. Penyedia mencatat kesalahan dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS. |
|
Pembuatan salinan bayangan lain sudah berlangsung. Terjadi saat menambahkan volume CSV ke rekam jepret yang diatur dari beberapa simpul secara bersamaan, atau saat menambahkan berbagi skala ke rekam jepret yang diatur dari beberapa simpul klien SMB secara bersamaan. |
|
Nilai parameter ProviderId GUID_NULL dan tidak ada penyedia VSS yang menunjukkan bahwa ia mendukung volume atau berbagi file jarak jauh yang ditentukan. |
|
Volume atau berbagi file jarak jauh tidak didukung oleh penyedia yang ditentukan. |
|
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. |
|
Penyedia mengembalikan kode galat yang tidak terduga. Kode kesalahan ini hanya dikembalikan melalui metode QueryStatus pada antarmuka IVssAsync yang dikembalikan dalam parameter ppAsync . |
Keterangan
Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP, dan Windows Server 2003: Berbagi file jarak jauh tidak didukung hingga Windows 8 dan Windows Server 2012.
Jika pwszVolumeName adalah jalur berbagi UNC, bagian nama server harus dalam format nama host atau nama domain yang sepenuhnya memenuhi syarat. Nama berbagi UNC dengan alamat IP harus dinormalisasi dengan memanggil metode IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths sebelum diteruskan ke AddToSnapshotSet.
Jumlah maksimum volume yang disalin bayangan dalam satu set salinan bayangan adalah 64.
Jika ProviderId GUID_NULL, penyedia default dipilih sesuai dengan algoritma berikut:
- Jika ada penyedia perangkat keras yang mendukung volume atau berbagi file jarak jauh yang diberikan, penyedia tersebut dipilih.
- Jika tidak ada penyedia perangkat keras yang tersedia, jika ada penyedia perangkat lunak yang mendukung volume yang diberikan, penyedia perangkat lunak akan dipilih.
- Jika tidak ada penyedia perangkat keras atau penyedia perangkat lunak yang tersedia, penyedia sistem dipilih. (Hanya ada satu penyedia sistem yang telah diinstal sebelumnya, yang harus mendukung semua volume lokal yang tidak dapat dilepaskan.)
Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: VHD tidak didukung.
Pengidentifikasi salinan bayangan yang dikembalikan dalam parameter pidSnapshot disimpan dalam Dokumen Komponen Cadangan. Namun, tidak ada metode untuk mengkueri informasi ini, dan pemanggil mungkin perlu menyimpannya sehingga dapat digunakan selama pemulihan.
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 |