Metode CVssWriter::GetSnapshotDeviceName (vswriter.h)

  • Artikel

Metode GetSnapshotDeviceName mengembalikan nama perangkat yang menghosting salinan bayangan volume atau berbagi file yang ditentukan. Metode ini memungkinkan penulis untuk mendukung salinan bayangan pemulihan otomatis , dan hanya dapat dipanggil selama pemrosesan metode OnPostSnapshot .

Sintaks

HRESULT GetSnapshotDeviceName(
  [in]  LPCWSTR wszOriginalVolume,
  [out] LPCWSTR *ppwszSnapshotDevice
);

Parameter

[in] wszOriginalVolume

Nama volume asli atau jalur UNC dari berbagi file asli yang berisi data yang digunakan untuk kumpulan salinan bayangan saat ini. 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)
  • Jalur UNC yang menentukan berbagi file jarak jauh, misalnya, \\Clusterx\Share1\

[out] ppwszSnapshotDevice

Alamat LPCWSTR yang akan menerima pointer ke nama perangkat salinan bayangan.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai Makna
S_OK
 Berhasil mengembalikan nama volume salinan bayangan.
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
VSS_E_BAD_STATE
 Panggilan tidak dilakukan selama peristiwa PostSnapshot.
VSS_E_OBJECT_NOT_FOUND
 Parameter wszOriginalVolume bukan salah satu volume atau berbagi file dalam set salinan bayangan.

Keterangan

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP, dan Windows Server 2003: Berbagi file jarak jauh tidak didukung hingga Windows 8 dan Windows Server 2012.

Untuk mendapatkan nama volume asli untuk parameter wszOriginalVolume , pertama-tama panggil metode CVssWriter::GetCurrentVolumeCount untuk mengkueri jumlah volume dalam set salinan bayangan. Kemudian panggil metode CVssWriter::GetCurrentVolumeArray untuk menghitung nama asli volume dalam set salinan bayangan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008, Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform Windows
Header vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka VssApi.lib