IVdsVolumeShrink：：QueryMaxReclaimableBytes 方法 (vds.h)

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

检索可从当前卷回收的最大字节数。

语法

HRESULT QueryMaxReclaimableBytes(
  [out] ULONGLONG *pullMaxNumberOfReclaimableBytes
);

[out] pullMaxNumberOfReclaimableBytes

指向变量的指针，该变量在成功完成后接收可从当前卷回收的最大字节数。此数字始终是文件系统群集大小的倍数，后者又是磁盘扇区大小的倍数。此参数是必需的，不能为 null。

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

返回代码/值	说明
S_OK	该方法已成功完成。
VDS_E_CANNOT_SHRINK 0x8004251EL	无法收缩卷，因为文件系统不支持它。
VDS_E_DISK_REMOVEABLE 0x8004255AL	操作在可移动媒体上不受支持。
RPX_X_NULL_REF_POINTER 0x800706F4	pullMaxNumberOfReclaimableBytes 参数在输入时为 null。

此方法可以返回比实际可用更多的可回收字节。