IVdsVolume::D elete 方法 (vds.h)

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

删除卷和所有丛,释放盘区。

语法

HRESULT Delete(
  [in] BOOL bForce
);

参数

[in] bForce

如果 为 TRUE,则即使卷正在使用,VDS 也会删除该卷;否则,如果正在使用卷,则不会删除该卷。

返回值

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

返回代码 说明
S_OK
已成功删除这些丛。

备注

只能从联机包中删除卷。 使用 IVdsPack::GetProperties 方法确认包状态为 VDS_PS_ONLINE

不能删除可移动媒体上的卷。

VDS 在删除卷之前卸载文件系统,这是 FAT 和 FAT32(而不是 NTFS)所需的操作。 此外,VDS 在删除卷本身后会删除卷的所有访问路径。 如果卸载操作失败,并且 bForce为 true,VDS 将删除卷而不进行卸载。 文件系统客户端应用程序必须处理这种情况。 如果卸载成功,并且删除操作失败,VDS 将尝试重新装载卷。

VDS 可防止删除当前系统和启动卷,以及页面文件、故障转储和休眠卷。 可以移动或重置故障转储和页面文件。 休眠卷必须保留在启动分区上。

Windows Server 2003: 故障转储和休眠卷必须保留在启动分区上。

Windows Server 2003: 删除卷后,VDS 会尝试删除已装载的文件夹。 如果此操作失败, 即使 已成功删除卷,Delete 也会返回 VDS_S_ACCESS_PATH_NOT_DELETED

要求

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

另请参阅

IVdsPack::GetProperties

IVdsVolume

VDS_PACK_STATUS