通过

IVdsVolumeShrink：：Shrink 方法 (vds.h)

  • 项目

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

收缩音量和所有丛，并返回释放的盘区。

语法

HRESULT Shrink(
  [in]  ULONGLONG ullDesiredNumberOfReclaimableBytes,
  [in]  ULONGLONG ullMinNumberOfReclaimableBytes,
  [out] IVdsAsync **ppAsync
);

参数

[in] ullDesiredNumberOfReclaimableBytes

缩小卷大小所依据的最大字节数。 此参数的值必须大于或等于 ullMinNumberOfReclaimableBytes 参数的值。 如果指定的字节数不是文件系统群集大小的倍数， Shrink 方法会将此值向上舍入到文件系统群集大小的下一个倍数。

[in] ullMinNumberOfReclaimableBytes

缩小卷大小的最小字节数。 如果卷大小不能至少收缩到此字节数， 则 Shrink 方法将失败。 如果指定的字节数不是文件系统群集大小的倍数， Shrink 方法会将此值向上舍入到文件系统群集大小的下一个倍数。 指定零以指示 Shrink 方法成功 不需要最小可回收字节数。

[out] ppAsync

IVdsAsync 接口指针的地址。 VDS 在返回时初始化接口。 调用方必须释放接口。 使用此接口可取消、等待或查询操作的状态。 如果调用 IVdsAsync：：Wait 并返回成功的 HRESULT 值，则必须通过在每个接口指针上调用 IUnknown：：Release 方法释放VDS_ASYNC_OUTPUT结构中返回的接口。 但是，如果 Wait 返回失败的 HRESULT 值，或者如果 Wait 的 pHrResult 参数收到失败的 HRESULT 值，则VDS_ASYNC_OUTPUT结构中的接口指针为 NULL，不需要释放。 可以使用 Winerror.h 中定义的 SUCCEEDED 和 FAILED 宏测试成功或失败 HRESULT 值。

返回值

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

返回代码/值 说明
S_OK
 该方法已成功完成。
VDS_E_CANNOT_SHRINK
0x8004251EL
 无法收缩卷，因为文件系统不支持它。
VDS_E_DISK_REMOVEABLE
0x8004255AL
 操作在可移动媒体上不受支持。
VDS_E_INTERNAL_ERROR
0x80042448L
 发生内部错误。 有关更多详细信息，请查看事件日志。
VDS_S_NO_NOTIFICATION
0x00042517L
 未收到卷到达通知。 可能需要调用 IVdsService：：Refresh。
VDS_E_SHRINK_SIZE_TOO_BIG
0x80042574L
 指定的收缩大小太大，将导致卷小于最小卷大小。
VDS_E_SHRINK_SIZE_LESS_THAN_MIN
0x80042573L
 指定的收缩大小小于允许的最小收缩大小。
VDS_E_VOLUME_NOT_HEALTHY
0x8004243EL
 卷不正常。
VDS_E_VOLUME_SIMPLE_SPANNED
0x80042589L
 操作仅在简单卷或跨卷上受支持。

注解

Shrink 方法移动文件，使其尽可能靠近卷的开头，以便合并卷末尾的可用空间。 (卷末尾可以合并的可用空间量决定了卷可以收缩多少。) 然后它截断文件系统卷，减小其大小，然后截断分区或动态卷。

在几乎所有情况下，都会有一些不可移动的文件 (即无法移动的文件) 。 例如，文件系统和存储驱动程序元数据文件可能不可移动。 因此，卷的收缩量通常小于卷上的可用空间总量。

不可移动文件的数量和位置可能会因计算机而异，即使两台计算机的配置相同。

文件可能暂时不可移动。 因此，如果应用程序再次使用相同的参数调用此方法，则可以恢复额外的空间。

如果 ullDesiredNumberOfReclaimableBytes 和 ullMinNumberOfReclaimableBytes 参数均为零， 则 Shrink 方法将尽可能缩小卷。

仅 NTFS 和 RAW 卷支持收缩和 扩展 操作。

使用此方法收缩文件系统和卷。 如果 VDS 无法收缩卷，它会停止操作而不收缩文件系统。

每个卷一次只能执行一个收缩或碎片整理操作。Windows Server 2008 和 Windows Vista： 计算机上一次只能执行一个收缩或碎片整理操作。

实现者必须返回指向此方法的 IVdsAsync 接口的指针，即使调用未启动异步操作。

此方法与 IVdsVolume：：Shrink 方法相同。

可以使用 IVdsVolumeShrink：：QueryMaxReclaimableBytes 方法估计收缩操作要回收的字节数。 但是， QueryMaxReclaimableBytes 可以返回比实际可用更多的字节。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 vds.h
Library Uuid.lib

另请参阅

IVdsVolume：：Extend

IVdsVolumeShrink