IVdsService：：QueryUnallocatedDisks 方法 (vds.h)
[从 Windows 8 和 Windows Server 2012 开始，虚拟磁盘服务 COM 接口由 Windows 存储管理 API 取代。]
返回一个枚举对象，其中包含由 VDS 托管的未分配磁盘的列表。
语法
HRESULT QueryUnallocatedDisks(
[out] IEnumVdsObject **ppEnum
);
参数
[out] ppEnum
可用于将磁盘枚举为磁盘对象的IEnumVdsObject 接口指针的地址。 有关详细信息，请参阅 使用枚举对象。 当不再需要接口和每个磁盘对象时，调用方必须通过调用 IUnknown：：Release 方法释放这些对象。
返回值
此方法可以返回标准 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 特定于 VDS 的返回值。 它还可以使用 HRESULT_FROM_WIN32 宏返回转换的系统错误代码。 错误可能源自 VDS 本身或正在使用的基础 VDS 提供程序 。 可能的返回值包括以下内容。
| 返回代码/值 | 说明 |
|---|---|
|
已成功返回枚举。 |
|
VDS 初始化失败。 如果应用程序在服务完成初始化之前调用此方法，则会阻止该方法，直到初始化完成。 如果初始化失败，则返回此错误。 |
注解
任何提供程序都不声明未分配的磁盘。 它可能包含也可能不包含 MBR 或 GPT 分区格式信息。 通常是未初始化的磁盘。 如果磁盘状态为 VDS_DS_ONLINE 或 VDS_DS_OFFLINE，则磁盘未分配且未初始化。 如果 它是VDS_DS_UNKNOWN、 VDS_DS_NOT_READY、 VDS_DS_FAILED或 VDS_DS_MISSING，则它是未分配的，但 VDS 服务无法确定是否初始化它，可能是因为磁盘出现问题。
若要确定磁盘状态，请参阅磁盘VDS_DISK_PROP或VDS_DISK_PROP2结构的状态成员。
如果磁盘状态为 VDS_DS_ONLINE，则可以将磁盘添加到包中。
如果磁盘状态为 VDS_DS_OFFLINE，请尝试通过调用 IVdsDiskOnline：：Online 使磁盘联机。 如果对 Online 方法的调用成功，则可以将磁盘添加到包中。 如果对 Online 的调用失败，则无法使用磁盘。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vds.h |
| Library | Uuid.lib |