IVdsService::CleanupObsoleteMountPoints 方法 (vds.h)

[从 Windows 8 和 Windows Server 2012 开始,虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]

删除不再存在的卷的用户模式路径和装载的文件夹。

语法

HRESULT CleanupObsoleteMountPoints();

返回值

此方法可以返回标准 HRESULT 值,例如 E_INVALIDARGE_OUTOFMEMORY,以及 特定于 VDS 的返回值。 它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。 错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序 。 可能的返回值包括以下内容。

返回代码/值 说明
S_OK
已成功删除过时的用户模式路径和装载的文件夹。
VDS_E_INITIALIZED_FAILED
0x80042401L
VDS 初始化失败。 如果应用程序在服务完成初始化之前调用此方法,则会阻止该方法,直到初始化完成。 如果初始化失败,则返回此错误。

注解

默认情况下,注册表保留已卸载卷的驱动器号映射信息。 如果从计算机中删除包含该卷的磁盘,则会保留该注册表项,以便当磁盘和卷返回到同一台计算机时,卷将收到相同的驱动器号。 如果将磁盘移动到新计算机,则注册表项不会随它一起移动,因此卷可能会收到不同的驱动器号和卷 GUID。

CleanupObsoleteMountPoints 方法删除这些注册表项。 有三种类型的注册表项被删除:

  • 如果卷没有驱动器号或卷 GUID,则它有一个“无驱动器号”注册表项,此方法将删除该注册表项。
  • 否则,卷具有卷 GUID 的注册表项,可能还有驱动器号。 此方法删除了两者。
此外,如果卷包含任何已装载的文件夹, CleanupObsoleteMountPoints 将删除它们。 例如,如果正在删除 Disk1 上的 Volume1,而 Volume1 装载为 Disk2 上的 x:\MountVolume1,则 Disk2 上的 \MountVolume1 文件夹也会被删除。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 vds.h
Library Uuid.lib

另请参阅

IVdsService