IVssDifferentialSoftwareSnapshotMgmt：：ChangeDiffAreaMaximumSize 方法 (vsmgmt.h)

ChangeDiffAreaMaximumSize 方法更新特定卷的卷影副本存储区域最大大小。这可能不会立即生效。

语法

HRESULT ChangeDiffAreaMaximumSize(
  [in] VSS_PWSZ pwszVolumeName,
  [in] VSS_PWSZ pwszDiffAreaVolumeName,
  [in] LONGLONG llMaximumDiffSpace
);

[in] pwszVolumeName

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

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

[in] pwszDiffAreaVolumeName

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

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

[in] llMaximumDiffSpace

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

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

值	含义
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	卷影副本当前正在使用卷影副本存储区域。

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

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

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

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