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 为此字符串分配内存。
返回值
下面是此方法的有效返回代码。
| 值 | 含义 |
|---|---|
|
已成功公开卷影副本。 |
|
调用方没有足够的备份权限或不是管理员。 |
|
其中一个参数值无效。 |
|
调用方内存不足或其他系统资源。 |
|
备份组件对象未初始化，在还原操作期间调用了此方法，或者尚未在正确的顺序中调用此方法。 |
|
指定的卷影副本不存在。 |
|
预期的提供程序错误。 提供程序在事件日志中记录了错误。 有关详细信息，请参阅 VSS 下的事件和错误处理。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。 改用E_UNEXPECTED。 |
|
意外的提供程序错误。 错误代码记录在错误日志中。 有关详细信息，请参阅 VSS 下的事件和错误处理。 |
注解
调用方负责通过调用 CoTaskMemFree 函数释放 pwszExposed 参数指向的字符串。
公开永久性卷影副本时，它会在后续启动中保持公开状态。
公开卷的卷影副本时，卷影副本可以被视为可装载的设备或可用于文件共享的文件系统。
当卷作为设备公开时（与其他可装载设备一样），卷的卷影副本将在其装载点公开， (驱动器号或装载的文件夹) 从其根开始。
当作为文件共享公开时，可以共享卷 的 wszPathFromRoot) 指示的子集 (。
有关如何公开卷影副本的详细信息，请参阅 公开和呈现卷影复制卷。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
| Library | VssApi.lib |
另请参阅
IVssBackupComponents：：ImportSnapshots