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 方法。您可以將陰影複製儲存區域的大小變更為零，以刪除陰影複製儲存區域。