Metode IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx (vsmgmt.h)

Artikel
08/27/2023

Updates ukuran maksimum area penyimpanan salinan bayangan untuk volume tertentu. Ini mungkin tidak memiliki efek langsung. Jika parameter bVolatileFALSE, perubahan berlanjut bahkan jika komputer di-boot ulang.

Sintaks

HRESULT ChangeDiffAreaMaximumSizeEx(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace,
  [in] BOOL     bVolatile
);

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 dengan, 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 –1, ukuran maksimumnya tidak terbatas.

[in] bVolatile

TRUE untuk menunjukkan bahwa efek memanggil metode ChangeDiffAreaMaximumSizeEx tidak boleh dilanjutkan jika komputer di-boot ulang; jika tidak, FALSE.

Nilai defaultnya adalah FALSE.

Jika parameter llMaximumDiffSpace adalah nol, parameter bVolatile harus FALSE.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Makna
S_OK	Ukuran maksimum area penyimpanan salinan bayangan berhasil diubah.
E_ACCESSDENIED	Pemanggil 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_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	Terjadi kesalahan penyedia yang diharapkan. Kode kesalahan dicatat 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_IN_USE	Salinan bayangan saat ini menggunakan area penyimpanan salinan bayangan.

Keterangan

Metode ChangeDiffAreaMaximumSizeEx identik dengan metode IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize kecuali untuk parameter bVolatile .

Memanggil metode ChangeDiffAreaMaximumSizeEx dengan parameter bVolatile yang diatur ke FALSE sama dengan memanggil metode ChangeDiffAreaMaximumSize .

ChangeDiffAreaMaximumSizeEx membuat area penyimpanan salinan bayangan eksplisit, yang berarti bahwa itu 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 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	vsmgmt.h

Lihat juga

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize

Bagikan melalui