共用方式為


IVssBackupComponentsEx4::GetRootAndLogicalPrefixPaths 方法 (vsbackup.h)

將本機磁片區路徑或 UNC 共用路徑正規化,使其可以傳遞至 IVssBackupComponents::AddToSnapshotSet 方法。

語法

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

參數

[in] pwszFilePath

要正規化的路徑。

[out] ppwszRootPath

接收應該傳遞至 IVssBackupComponents::AddToSnapshotSet 方法的根路徑。

[out] ppwszLogicalPrefix

如果 pwszFilePath 是本機路徑,此參數會接收磁片區 GUID 名稱。 如果是 UNC 路徑,此參數會收到完整評估的共用路徑。

[in, optional] bNormalizeFQDNforRootPath

如果 pwszFilePath 是 UNC 共用路徑,伺服器名稱部分可以是

  • 主機名稱
  • 完整功能變數名稱
  • IP 位址

此參數會指定主機名稱格式或完整功能變數名稱格式是否應該用於 ppwszRootPath 參數中傳回之標準化根路徑的伺服器名稱部分。

如果此參數為 FALSE,將會使用簡單的主機名稱格式。

此參數的預設值為 FALSE

如果此參數為 TRUE,將會使用完整功能變數名稱。

在主機名稱可能存在於多個網域尾碼的部署中,此參數應該是 TRUE

傳回值

以下是此方法的有效傳回碼。

傳回碼 描述
S_OK
已成功傳回路徑資訊。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。

備註

此方法會將本機磁片區路徑或 UNC 共用路徑正規化,並將它分成根路徑和邏輯前置詞路徑。 接著,根路徑可以傳遞至 IVssBackupComponents::AddToSnapshotSet 方法。

如果 pwszFilePath 是本機磁片區路徑,則根路徑會類似于磁片區掛接點。 在此情況下,根和邏輯前置詞路徑會分別對應至 GetVolumePathNameGetVolumeNameForVolumeMountPoint的結果。

如果 pwszFilePath 是 UNC 共用路徑,則根和邏輯前置詞路徑會對應至檔案共用的根路徑,以及完整評估的實體共用路徑 (,這會將 DFS 和叢集部署分別納入考慮) 。

如果您針對相同的陰影複製集建立作業多次呼叫這個方法,您必須為每個呼叫將 bNormalizeFQDNforRootPath 設定為相同的值。 完整功能變數名稱格式和主機名稱格式不能在相同的陰影複製集中混合。

規格需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)

另請參閱

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponentsEx4