IVssBackupComponents::ExposeSnapshot 方法 (vsbackup.h)

ExposeSnapshot 方法将卷影副本公开为驱动器号、装载的文件夹或文件共享。

语法

HRESULT ExposeSnapshot(
  [in]  VSS_ID   SnapshotId,
  [in]  VSS_PWSZ wszPathFromRoot,
  [in]  LONG     lAttributes,
  [in]  VSS_PWSZ wszExpose,
  [out] VSS_PWSZ *pwszExposed
);

参数

[in] SnapshotId

卷影复制标识符。

[in] wszPathFromRoot

将卷影副本公开为文件共享时可用的卷部分的路径。 在本地公开卷影副本时,此参数的值必须为 NULL ;即,将其公开为驱动器号或装载的文件夹。

路径不能包含环境变量 (例如 %MyEnv%) 或通配符。

不要求路径以反斜杠 (“”) 结尾。 由应用程序来检索此信息以检查。

[in] lAttributes

公开的卷影副本的属性,指示它是在本地公开还是远程公开。 该值必须是 VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY_VSS_VOLUME_SNAPSHOT_ATTRIBUTES 的VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY值。

[in] wszExpose

当卷影副本作为文件共享公开时,此参数的值是共享名称。 如果通过将卷影副本装载为设备来公开卷影副本,则参数值是后跟冒号的驱动器号,例如,“X:”或装载的文件夹路径 (例如“Y:\MountX”) 。 如果此参数的值为 NULL,则如果 lAttributes 参数 VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY,VSS 将确定共享名称或驱动器号。

[out] pwszExposed

卷影副本的公开名称。 这是共享名称、后跟冒号的驱动器号或装载的文件夹。 如果 ExposeSnapshot 失败,则值为 NULL。 VSS 为此字符串分配内存。

返回值

下面是此方法的有效返回代码。

含义
S_OK
已成功公开卷影副本。
E_ACCESSDENIED
调用方没有足够的备份权限或不是管理员。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存不足或其他系统资源。
VSS_E_BAD_STATE
备份组件对象未初始化,在还原操作期间调用了此方法,或者尚未在正确的顺序中调用此方法。
VSS_E_OBJECT_NOT_FOUND
指定的卷影副本不存在。
VSS_E_PROVIDER_VETO
预期的提供程序错误。 提供程序在事件日志中记录了错误。 有关详细信息,请参阅 VSS 下的事件和错误处理
VSS_E_UNEXPECTED
意外错误。 错误代码记录在错误日志文件中。 有关详细信息,请参阅 VSS 下的事件和错误处理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支持此值。 改用E_UNEXPECTED。

VSS_E_UNEXPECTED_PROVIDER_ERROR
意外的提供程序错误。 错误代码记录在错误日志中。 有关详细信息,请参阅 VSS 下的事件和错误处理

注解

调用方负责通过调用 CoTaskMemFree 函数释放 pwszExposed 参数指向的字符串。

公开永久性卷影副本时,它会在后续启动中保持公开状态。

公开卷的卷影副本时,卷影副本可以被视为可装载的设备或可用于文件共享的文件系统。

当卷作为设备公开时(与其他可装载设备一样),卷的卷影副本将在其装载点公开, (驱动器号或装载的文件夹) 从其根开始。

当作为文件共享公开时,可以共享卷 的 wszPathFromRoot) 指示的子集 (。

有关如何公开卷影副本的详细信息,请参阅 公开和呈现卷影复制卷

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
Library VssApi.lib

另请参阅

IVssBackupComponents

IVssBackupComponents::ImportSnapshots

IVssBackupComponentsEx2::UnexposeSnapshot

VSS_PWSZ

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES