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。