IVdsAdvancedDisk：：QueryPartitions 方法 (vds.h)

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

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

语法

HRESULT QueryPartitions(
  [out] VDS_PARTITION_PROP **ppPartitionPropArray,
  [out] LONG               *plNumberOfPartitions
);

[out] ppPartitionPropArray

指向调用方传入的VDS_PARTITION_PROP 结构的数组的指针。调用方必须使用 CoTaskMemFree 函数释放此数组。

[out] plNumberOfPartitions

指向 ppPartitionPropArray 参数中返回的数组中的元素数的指针。

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

返回代码	说明
S_OK	查询成功。
S_FALSE	磁盘不包含任何分区。

如果磁盘包含扩展分区，则此方法仅返回第一个扩展分区，而不管磁盘上有多少个扩展分区。磁盘包含每个逻辑驱动器的一个扩展分区。有关逻辑驱动器的详细信息，请参阅 Disk Object。