Metode IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea (vsmgmt.h)

  • Artikel

Metode AddDiffArea menambahkan asosiasi area penyimpanan salinan bayangan untuk volume yang ditentukan. Jika asosiasi tidak didukung, kode kesalahan akan dikembalikan.

Sintaks

HRESULT AddDiffArea(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

Parameter

[in] pwszVolumeName

Nama volume yang akan menjadi sumber salinan bayangan. Volume ini dikaitkan dengan area penyimpanan salinan bayangan pada volume pwszDiffAreaVolumeName .

Nama volume 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)

[in] pwszDiffAreaVolumeName

Nama volume yang akan berisi area penyimpanan salinan bayangan yang akan dikaitkan dengan volume pwszVolumeName .

Nama volume harus dalam salah satu format berikut dan harus menyertakan garis miring terbalik berikutnya (\):

  • Jalur folder yang dipasang
  • Huruf kandar, misalnya, D:\
  • Jalur GUID volume dari formulir \\?\Volume{GUID}\ (di mana GUID mengidentifikasi volume)

[in] llMaximumDiffSpace

Ukuran maksimum, dalam byte, dari area penyimpanan salinan bayangan pada volume. Nilai ini harus minimal 320 MB, hingga batas seluruh sistem. Jika nilai ini –1, ukuran maksimumnya tidak terbatas.

Windows Server 2003: Sebelum Windows Server 2003 dengan SP1, ukuran area penyimpanan salinan bayangan diperbaiki pada 100 MB.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Makna
S_OK
 Berhasil menambahkan asosiasi area penyimpanan salinan bayangan.
E_ACCESSDENIED
 Penelepon tidak memiliki hak istimewa pencadangan yang memadai atau bukan administrator.
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED
 Jumlah maksimum area penyimpanan salinan bayangan telah ditambahkan ke volume sumber salinan bayangan. Volume penyimpanan salinan bayangan yang ditentukan tidak terkait dengan volume sumber salinan bayangan yang ditentukan.
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_OBJECT_ALREADY_EXISTS
 Hubungan antara pwszVolumeName dan pwszDiffAreaVolumeName volume sudah ada.
VSS_E_PROVIDER_VETO
 Kesalahan penyedia yang diharapkan. Penyedia mencatat kesalahan dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
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_VOLUME_NOT_SUPPORTED
 Volume pwszDiffAreaVolumeName bukan volume NTFS atau memiliki ruang kosong yang tidak mencukupi.

Keterangan

Asosiasi area penyimpanan salinan bayangan tidak dapat dibuat jika salinan bayangan sudah ada untuk volume pwszVolumeName atau jika sudah ada asosiasi area penyimpanan salinan bayangan untuk volume tersebut.

Area penyimpanan salinan bayangan untuk volume sumber hard disk virtual (VHD) harus berada pada volume yang sama. Demikian juga, area penyimpanan salinan bayangan hanya dapat dibuat pada volume VHD jika volume sumber sama untuk kedua volume.

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

Untuk mengubah ukuran area penyimpanan salinan bayangan, gunakan metode IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize atau IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx . Anda dapat menghapus area penyimpanan salinan bayangan dengan mengubah ukurannya menjadi nol.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tidak ada yang didukung
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header vsmgmt.h

Lihat juga

IVssDifferentialSoftwareSnapshotMgmt