Metode IVssDifferentialSoftwareSnapshotMgmt3::SetVolumeProtectLevel (vsmgmt.h)

Mengatur tingkat perlindungan salinan bayangan untuk volume asli atau volume area penyimpanan salinan bayangan.

Sintaks

HRESULT SetVolumeProtectLevel(
  [in] VSS_PWSZ             pwszVolumeName,
  [in] VSS_PROTECTION_LEVEL protectionLevel
);

Parameter

[in] pwszVolumeName

Nama volume. Parameter ini diperlukan dan tidak boleh NULL.

Nama 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 dalam formulir \\?\Volume{GUID}\ (di mana GUID mengidentifikasi volume)

[in] protectionLevel

Nilai dari enumerasi VSS_PROTECTION_LEVEL yang menentukan tingkat perlindungan salinan bayangan.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
Tingkat perlindungan salinan bayangan berhasil disetel.
E_ACCESSDENIED
0x80070005L
Penelepon bukan administrator.
E_INVALIDARG
0x80070057L
Salah satu nilai parameter tidak valid.
E_NOTIMPL
0x80000001L
Penyedia untuk volume tidak mendukung perlindungan salinan bayangan.
VSS_E_PROVIDER_VETO
0x80042306L
Terjadi kesalahan penyedia yang diharapkan. Kode kesalahan dicatat dalam log peristiwa. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
VSS_E_OBJECT_NOT_FOUND
0x80042308L
Volume yang ditentukan tidak ditemukan.

Keterangan

Metode SetVolumeProtectLevel memeriksa tingkat perlindungan salinan bayangan volume saat ini. Jika volume dalam keadaan rusak dan VSS_PROTECTION_LEVEL_ORIGINAL_VOLUME ditentukan untuk parameter protectionLevel , SetVolumeProtectLevel melepas volume sebelum mengatur tingkat perlindungan.

Jika tingkat perlindungan volume saat ini sama dengan nilai parameter protectionLevel , SetVolumeProtectLevel tidak melakukan apa pun.

Jika nilai parameter protectionLevelVSS_PROTECTION_LEVEL_SNAPSHOT, pemohon harus mengatur asosiasi area penyimpanan salinan bayangan (area diff) menggunakan metode IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea .

Persyaratan

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

Lihat juga

IVssDifferentialSoftwareSnapshotMgmt3

IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel