通过

IVssDifferentialSoftwareSnapshotMgmt2：：ChangeDiffAreaMaximumSizeEx 方法 (vsmgmt.h)

  • 项目

汇报特定卷的卷影副本存储区域最大大小。 这可能不会立即生效。 如果 bVolatile 参数为 FALSE，则即使计算机重新启动，更改也会继续。

语法

HRESULT ChangeDiffAreaMaximumSizeEx(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace,
  [in] BOOL     bVolatile
);

参数

[in] pwszVolumeName

卷影副本源的卷的名称。 此卷与 pwszDiffAreaVolumeName 卷上的卷影副本存储区域相关联。

卷的名称必须使用以下格式之一，并且必须包含尾随反斜杠 (\) ：

  • 已装载文件夹的路径，例如 Y：\MountX\
  • 驱动器号，例如 D：\
  • 格式为 \\？\Volume{GUID}\ (的卷 GUID 路径，其中 GUID 标识卷)

[in] pwszDiffAreaVolumeName

卷的名称，该卷包含与 pwszVolumeName 卷关联的卷影副本存储区域。

卷的名称必须使用以下格式之一，并且必须包含尾随反斜杠 (\) ：

  • 已装载文件夹的路径
  • 驱动器号，例如 D：\
  • 格式为 \\？\Volume{GUID}\ (的卷 GUID 路径，其中 GUID 标识卷)

[in] llMaximumDiffSpace

指定要用于卷的卷影副本存储区域的最大大小（以字节为单位）。 如果此值为零，则将删除卷影副本存储区域。 如果此值为 –1，则最大大小不受限制。

[in] bVolatile

如果为 TRUE，则表示如果计算机重新启动，则调用 ChangeDiffAreaMaximumSizeEx 方法的效果不应继续;否则为 FALSE。

默认值为 FALSE。

如果 llMaximumDiffSpace 参数为零，则 bVolatile 参数必须为 FALSE。

返回值

此方法可以返回其中一个值。

值 含义
S_OK
 已成功更改卷影副本存储区域最大大小。
E_ACCESSDENIED
 调用方没有足够的备份权限或不是管理员。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存或其他系统资源不足。
VSS_E_INSUFFICIENT_STORAGE
 pwszDiffAreaVolumeName 卷没有足够的可用空间。
VSS_E_OBJECT_NOT_FOUND
 找不到 pwszVolumeName 和 pwszDiffAreaVolumeName 卷之间的关联。
VSS_E_PROVIDER_VETO
 发生了预期的提供程序错误。 错误代码记录在事件日志中。 有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_UNEXPECTED
 意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前不支持此值。 改用E_UNEXPECTED。
VSS_E_VOLUME_IN_USE
 卷影副本当前正在使用卷影副本存储区域。

注解

ChangeDiffAreaMaximumSizeEx 方法与 IVssDifferentialSoftwareSnapshotMgmt：：ChangeDiffAreaMaximumSize 方法相同，但 bVolatile 参数除外。

调用将 bVolatile 参数设置为 FALSE 的 ChangeDiffAreaMaximumSizeEx 方法与调用 ChangeDiffAreaMaximumSize 方法相同。

ChangeDiffAreaMaximumSizeEx 使卷影副本存储区域变得显式，这意味着在删除所有卷影副本时不会自动删除它。

如果卷影副本存储区域不存在，此方法将创建它。

Windows Server 2008、Windows Vista 和 Windows Server 2003： 如果卷影副本存储区域不存在，则此方法不会创建它。

若要创建卷影副本存储区域，请使用 IVssDifferentialSoftwareSnapshotMgmt：：AddDiffArea 方法。

要求

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

另请参阅

IVssDifferentialSoftwareSnapshotMgmt2

IVssDifferentialSoftwareSnapshotMgmt：：ChangeDiffAreaMaximumSize