Metode IVssBackupComponents::AddToSnapshotSet (vsbackup.h)

  • Artikel

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
S_OK
0x00000000L
 Berhasil menambahkan volume atau berbagi file jarak jauh ke kumpulan salinan bayangan.
E_ACCESSDENIED
0x80070005L
 Penelepon tidak memiliki hak istimewa pencadangan 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_BAD_STATE
0x80042301L
 Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar.
VSS_E_MAXIMUM_NUMBER_OF_VOLUMES_REACHED
0x80042312L
 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.
VSS_E_MAXIMUM_NUMBER_OF_SNAPSHOTS_REACHED
0x80042317L
 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.
VSS_E_NESTED_VOLUME_LIMIT
0x8004232CL
 Volume yang ditentukan ditumpuk terlalu dalam untuk berpartisipasi dalam operasi VSS. Kemungkinan alasan kesalahan ini meliputi hal-hal berikut:
  • Mencoba membuat salinan bayangan volume yang berada di VHD yang terkandung dalam VHD lain.
  • Mencoba membuat salinan bayangan volume VHD ketika volume yang berisi VHD juga berada dalam set salinan bayangan yang sama.
Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Kode pengembalian ini tidak didukung.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 pwszVolumeName tidak sesuai dengan volume yang ada atau berbagi file jarak jauh.
VSS_E_PROVIDER_NOT_REGISTERED
0x80042304L
 ProviderId tidak sesuai dengan penyedia terdaftar.
VSS_E_PROVIDER_VETO
0x80042306L
 Kesalahan penyedia yang diharapkan. Penyedia mencatat kesalahan dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_SNAPSHOT_SET_IN_PROGRESS
0x80042316L
 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.
VSS_E_VOLUME_NOT_SUPPORTED
0x8004230CL
 Nilai parameter ProviderId GUID_NULL dan tidak ada penyedia VSS yang menunjukkan bahwa ia mendukung volume atau berbagi file jarak jauh yang ditentukan.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
0x8004230EL
 Volume atau berbagi file jarak jauh tidak didukung oleh penyedia yang ditentukan.
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
0x8004230FL
 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:

  1. Jika ada penyedia perangkat keras yang mendukung volume atau berbagi file jarak jauh yang diberikan, penyedia tersebut dipilih.
  2. Jika tidak ada penyedia perangkat keras yang tersedia, jika ada penyedia perangkat lunak yang mendukung volume yang diberikan, penyedia perangkat lunak akan dipilih.
  3. 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.)
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.

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

Lihat juga

IVssBackupComponents

IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES