IVssDifferentialSoftwareSnapshotMgmt：：AddDiffArea 方法 (vsmgmt.h)

AddDiffArea 方法为指定卷添加卷影复制存储区域关联。如果不支持关联，将返回错误代码。

语法

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

[in] pwszVolumeName

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

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

[in] pwszDiffAreaVolumeName

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

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

[in] llMaximumDiffSpace

卷上的卷影副本存储区域的最大大小（以字节为单位）。此值必须至少为 320 MB，达到系统范围的限制。如果此值为 –1，则最大大小不受限制。

Windows Server 2003： 在 Windows Server 2003 SP1 之前，卷影副本存储区域大小固定为 100 MB。

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

值	含义
S_OK	已成功添加卷影副本存储区域关联。
E_ACCESSDENIED	调用方没有足够的备份权限或不是管理员。
E_INVALIDARG	其中一个参数值无效。
E_OUTOFMEMORY	调用方内存不足或其他系统资源。
VSS_E_MAXIMUM_DIFFAREA_ASSOCIATIONS_REACHED	卷影副本存储区域已添加到卷影复制源卷的最大数目。指定的卷影复制存储卷未与指定的卷影复制源卷关联。
VSS_E_NESTED_VOLUME_LIMIT	指定的卷嵌套太深，无法参与 VSS 操作。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支持此返回代码。
VSS_E_OBJECT_ALREADY_EXISTS	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_NOT_SUPPORTED	pwszDiffAreaVolumeName 卷不是 NTFS 卷，或者可用空间不足。

如果 pwszVolumeName 卷已存在任何卷影副本，或者已存在该卷的卷影复制存储区域关联，则无法创建卷影复制存储区域关联。

虚拟硬盘 (VHD) 源卷的卷影复制存储区域必须位于同一卷上。同样，如果两个卷的源卷相同，则只能在 VHD 卷上创建卷影副本存储区域。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支持 VHD。

若要更改卷影复制存储区域的大小，请使用 IVssDifferentialSoftwareSnapshotMgmt：：ChangeDiffAreaMaximumSize 或 IVssDifferentialSoftwareSnapshotMgmt2：：ChangeDiffAreaMaximumSizeEx 方法。可以通过将卷影副本存储区域的大小更改为零来删除卷影副本存储区域。