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