Metode IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths (vsbackup.h)

  • Artikel

Menormalkan jalur volume lokal atau jalur berbagi UNC sehingga dapat diteruskan ke metode IVssBackupComponents::AddToSnapshotSet .

Sintaks

HRESULT GetRootAndLogicalPrefixPaths(
  [in]           VSS_PWSZ pwszFilePath,
  [out]          VSS_PWSZ *ppwszRootPath,
  [out]          VSS_PWSZ *ppwszLogicalPrefix,
  [in, optional] BOOL     bNormalizeFQDNforRootPath
);

Parameter

[in] pwszFilePath

Jalur yang akan dinormalisasi.

[out] ppwszRootPath

Menerima jalur akar yang harus diteruskan ke metode IVssBackupComponents::AddToSnapshotSet .

[out] ppwszLogicalPrefix

Jika pwszFilePath adalah jalur lokal, parameter ini menerima nama GUID volume. Jika ini adalah jalur UNC, parameter ini menerima jalur berbagi yang sepenuhnya dievaluasi.

[in, optional] bNormalizeFQDNforRootPath

Jika pwszFilePath adalah jalur berbagi UNC, bagian nama server dapat

  • Nama host
  • Sebuah nama domain yang sepenuhnya memenuhi syarat
  • Alamat IP

Parameter ini menentukan apakah format nama host atau format nama domain yang sepenuhnya memenuhi syarat harus digunakan dalam bagian nama server dari jalur akar yang dinormalisasi yang dikembalikan dalam parameter ppwszRootPath .

Jika parameter ini FALSE, format nama host sederhana akan digunakan.

Nilai default untuk parameter ini adalah FALSE.

Jika parameter ini TRUE, nama domain yang sepenuhnya memenuhi syarat akan digunakan.

Dalam penyebaran di mana nama host bisa ada di beberapa akhiran domain, parameter ini harus TRUE.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Menampilkan kode Deskripsi
S_OK
 Berhasil mengembalikan informasi jalur.
E_OUTOFMEMORY
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.

Keterangan

Metode ini menormalkan jalur volume lokal atau jalur berbagi UNC dan memisahkannya menjadi jalur akar dan jalur awalan logis. Jalur akar kemudian dapat diteruskan ke metode IVssBackupComponents::AddToSnapshotSet .

Jika pwszFilePath adalah jalur volume lokal, jalur akar akan mirip dengan titik pemasangan volume. Dalam hal ini, akar dan jalur awalan logis masing-masing memetakan hasil GetVolumePathName dan GetVolumeNameForVolumeMountPoint.

Jika pwszFilePath adalah jalur berbagi UNC, jalur awalan akar dan logis memetakan ke jalur akar berbagi file dan jalur berbagi fisik yang sepenuhnya dievaluasi (yang masing-masing akan memperhitungkan DFS dan penyebaran kluster).

Jika Anda memanggil metode ini lebih dari sekali untuk operasi pembuatan set salinan bayangan yang sama, Anda harus mengatur bNormalizeFQDNforRootPath ke nilai yang sama untuk setiap panggilan. Format nama domain dan format nama host yang sepenuhnya memenuhi syarat tidak dapat dicampur dalam kumpulan salinan bayangan yang sama.

Persyaratan

   
Klien minimum yang didukung Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h)

Lihat juga

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4