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 提供程序 。 可能的返回值包括以下内容。
返回代码 | 说明 |
---|---|
|
已成功删除这些丛。 |
备注
只能从联机包中删除卷。 使用 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 |