Metode IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize (vsmgmt.h)

  • Artikel

Metode ChangeDiffAreaMaximumSize memperbarui ukuran maksimum area penyimpanan salinan bayangan untuk volume tertentu. Ini mungkin tidak memiliki efek langsung.

Sintaks

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

Parameter

[in] pwszVolumeName

Nama volume yang merupakan 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 berisi area penyimpanan salinan bayangan yang terkait 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

Menentukan ukuran maksimum, dalam byte, untuk area penyimpanan salinan bayangan yang akan digunakan untuk volume. Jika nilai ini nol, area penyimpanan salinan bayangan akan dihapus. Jika nilai ini adalah -1, ukuran maksimum tidak terbatas.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Makna
S_OK
 Berhasil mengubah ukuran maksimum area penyimpanan salinan bayangan.
E_ACCESSDENIED
 Penelepon tidak memiliki hak 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_INSUFFICIENT_STORAGE
 Volume pwszDiffAreaVolumeName tidak memiliki ruang kosong yang cukup.
VSS_E_OBJECT_NOT_FOUND
 Hubungan antara volume pwszVolumeName dan pwszDiffAreaVolumeName tidak ditemukan.
VSS_E_PROVIDER_VETO
 Kesalahan penyedia - penyedia mencatat kesalahan di 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_IN_USE
 Salinan bayangan saat ini menggunakan area penyimpanan salinan bayangan.

Keterangan

Metode ChangeDiffAreaMaximumSize membuat area penyimpanan salinan bayangan menjadi eksplisit, yang berarti tidak dihapus secara otomatis ketika semua salinan bayangan dihapus.

Jika area penyimpanan salinan bayangan tidak ada, metode ini akan membuatnya.

Windows Server 2008, Windows Vista, dan Windows Server 2003: Jika area penyimpanan salinan bayangan tidak ada, metode ini tidak membuatnya.

Untuk membuat area penyimpanan salinan bayangan, gunakan metode IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

Persyaratan

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

Lihat juga

IVssDifferentialSoftwareSnapshotMgmt