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 提供程序 。 可能的返回值包括以下内容。

返回代码/值 说明
S_OK
 已成功返回枚举。
VDS_E_INITIALIZED_FAILED
0x80042401L
 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

另请参阅

IEnumVdsObject

IVdsService