Share via

Metode IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel (vsmgmt.h)

  • Artikel

Mendapatkan tingkat perlindungan salinan bayangan dan status untuk volume yang ditentukan.

Sintaks

HRESULT GetVolumeProtectLevel(
  [in]  VSS_PWSZ                   pwszVolumeName,
  [out] VSS_VOLUME_PROTECTION_INFO *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)

[out] protectionLevel

Alamat buffer yang dialokasikan penelepon yang menerima struktur VSS_VOLUME_PROTECTION_INFO yang berisi informasi tentang tingkat perlindungan salinan bayangan volume.

Nilai kembali

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Tingkat perlindungan salinan bayangan berhasil dikueri.
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 GetVolumeProtectLevel mendapatkan informasi tentang tingkat perlindungan volume saat ini. Jika volume dalam keadaan rusak, anggota m_protectionFault struktur VSS_VOLUME_PROTECTION_INFO berisi kesalahan perlindungan saat ini, dan anggota m_failureStatus berisi alasan mengapa volume dalam keadaan rusak. Jika volume tidak dalam keadaan rusak, anggota m_protectionFault dan m_failureStatus akan menjadi nol.

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::SetVolumeProtectLevel