IVdsDisk：：QueryExtents 方法 (vds.h)

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

返回磁盘上所有盘区的详细信息。

语法

HRESULT QueryExtents(
  [out] VDS_DISK_EXTENT **ppExtentArray,
  [out] LONG            *plNumberOfExtents
);

[out] ppExtentArray

接收的指针变量
VDS_DISK_EXTENT 结构的数组。调用方必须使用 CoTaskMemFree 函数释放此数组。

[out] plNumberOfExtents

表示盘区总数的 LONG 类型的地址。

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

返回代码/值	说明
S_OK	已成功返回盘区信息。
VDS_E_PACK_OFFLINE 0x80042444L	磁盘所属的包不可访问。

使用此方法确定用于创建或扩展卷的可用空间量。还可以使用盘区信息来确定占用磁盘的卷数。有效盘区类型包括：未知盘区、可用盘区、数据区、OEM 盘区、ESP 盘区、MSR 盘区、LDM 元数据盘区以及不可用的盘区。数据区包含指向其上卷的链接。

如果磁盘是动态磁盘，则它必须处于联机状态。如果它是基本磁盘或原始磁盘，它可以联机或脱机。