Fungsi IsVolumeSnapshotted (vsbackup.h)

  • Artikel

Fungsi IsVolumeSnapshotted menentukan apakah ada salinan bayangan untuk volume yang ditentukan.

Catatan Fungsi ini diekspor sebagai IsVolumeSnapshottedInternal, tetapi Anda harus memanggil IsVolumeSnapshotted, bukan IsVolumeSnapshottedInternal.
 

Sintaks

HRESULT IsVolumeSnapshotted(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSnapshotsPresent,
  [out] LONG     *plSnapshotCapability
);

Parameter

[in] pwszVolumeName

Nama volume. Nama volume yang akan diperiksa 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)

[out] pbSnapshotsPresent

Nilai parameter ini TRUE jika volume memiliki salinan bayangan, dan FALSE jika volume tidak memiliki salinan bayangan.

[out] plSnapshotCapability

Masker bit (atau bitwise OR) dari nilai VSS_SNAPSHOT_COMPATIBILITY yang menunjukkan apakah kontrol volume atau operasi I/O file tertentu dinonaktifkan untuk volume yang diberikan jika salinan bayangannya ada.

Nilai kembali

Nilai yang dikembalikan yang tercantum di sini adalah selain HRESULTCOM normal yang dapat dikembalikan kapan saja dari fungsi .

Nilai Makna
S_OK
 Fungsi berhasil diselesaikan.
E_ACCESSDENIED
 Pemanggil tidak memiliki hak pencadangan yang memadai atau bukan administrator.
E_INVALIDARG
 Salah satu parameter tidak valid.
E_OUTOFMEMORY
 Kehabisan memori atau sumber daya sistem lainnya.
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_OBJECT_NOT_FOUND
 Volume yang ditentukan tidak ditemukan.
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_UNEXPECTED_PROVIDER_ERROR
 Kesalahan penyedia tak terduga. Kode kesalahan dicatat dalam file log peristiwa. Untuk informasi tambahan, lihat Penanganan Peristiwa dan Kesalahan Di bawah VSS.

Keterangan

Sebelum memanggil fungsi ini, pemanggil harus menginisialisasi COM dengan memanggil fungsi CoInitialize .

Jika tidak ada kontrol volume atau operasi I/O file yang dinonaktifkan untuk volume yang dipilih, maka kemampuan salinan bayangan dari volume yang dipilih yang dikembalikan oleh plSnapshotCapability akan menjadi nol.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)
Pustaka VssApi.lib
DLL VssApi.dll

Lihat juga

VSS_SNAPSHOT_COMPATIBILITY