通过

IVdsService：：CleanupObsoleteMountPoints 方法 (vds.h)

  • 项目

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

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

语法

HRESULT CleanupObsoleteMountPoints();

返回值

此方法可以返回标准 HRESULT 值，例如 E_INVALIDARG 或 E_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