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

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

删除 LUN 及其所有丛。 LUN 上的任何数据都将丢失。 VDS 释放分配给 LUN 的盘区。

语法

HRESULT Delete();

返回值

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

返回代码/值 说明
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
此返回值表示提供程序内部存在软件或通信问题,该提供程序缓存有关数组的信息。 使用 IVdsHwProvider::Reenumerate 方法,后跟 IVdsHwProvider::Refresh 方法还原缓存。
VDS_E_OBJECT_DELETED
0x8004240BL
LUN 对象不再存在。
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
LUN 处于失败状态,无法执行请求的操作。
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
另一个操作正在进行中:在上一个操作完成之前,此操作无法继续。

备注

如果应用程序持有对 IVdsLun 接口的引用并调用 IVdsLun::D elete,则实现者应在后续调用方法(如该接口上的 GetProperties)时返回VDS_E_OBJECT_DELETED。 在这种情况下,接口具有未完成的引用并且有效,但基础对象不再存在。

如果删除了已取消屏蔽到目标计算机的 LUN,则在执行总线重新扫描之前,该 LUN 在该计算机上的可见性可能不会更改。 目标计算机上的 VDS 应用程序通过调用 IVdsService::Reenumerate 启动总线重新扫描。 启动总线重新扫描由 VDS 应用程序负责,而不是硬件提供商。

如果在一个线程中调用 IVdsLun::D elete 等方法,而在同时运行的另一个线程中调用 IVdsSubSystem::QueryLuns ,则结果可能是提供程序访问冲突。 硬件提供程序负责根据需要序列化这些方法,以最大限度地减少此类同步问题。

硬件提供程序负责删除 LUN 的分区信息,以便可以重复使用 LUN。 如果 LUN 是 MBR 磁盘,则通过向第一个和最后 1 MB 磁盘写入零来实现。 对于 GPT 磁盘,必须将零写入磁盘的第一个和最后 16 KB。

要求

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

另请参阅

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsLun

IVdsLun::GetProperties