IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea 메서드(vsmgmt.h)
AddDiffArea 메서드는 지정된 볼륨에 대한 섀도 복사본 스토리지 영역 연결을 추가합니다. 연결이 지원되지 않으면 오류 코드가 반환됩니다.
구문
HRESULT AddDiffArea(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_PWSZ pwszDiffAreaVolumeName,
[in] LONGLONG llMaximumDiffSpace
);
매개 변수
[in] pwszVolumeName
섀도 복사본의 원본이 될 볼륨의 이름입니다. 이 볼륨은 pwszDiffAreaVolumeName 볼륨의 섀도 복사본 스토리지 영역과 연결됩니다.
볼륨 이름은 다음 형식 중 하나여야 하며 후행 백슬래시(\)를 포함해야 합니다.
- 탑재된 폴더의 경로(예: Y:\MountX\
- 드라이브 문자(예: D:\
- \\?\Volume{GUID}\ 형식의 볼륨GUID 경로(여기서 GUID 는 볼륨을 식별)
[in] pwszDiffAreaVolumeName
pwszVolumeName 볼륨과 연결할 섀도 복사본 스토리지 영역을 포함할 볼륨의 이름입니다.
볼륨 이름은 다음 형식 중 하나여야 하며 후행 백슬래시(\)를 포함해야 합니다.
- 탑재된 폴더의 경로
- 드라이브 문자(예: D:\
- \\?\Volume{GUID}\ 형식의 볼륨GUID 경로(여기서 GUID 는 볼륨을 식별)
[in] llMaximumDiffSpace
볼륨의 섀도 복사본 스토리지 영역의 최대 크기(바이트)입니다. 이 값은 시스템 전체 제한까지 320MB 이상이어야 합니다. 이 값이 –1이면 최대 크기는 무제한입니다.
Windows Server 2003: WINDOWS Server 2003 SP1 이전에는 섀도 복사본 스토리지 영역 크기가 100MB로 고정되었습니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | 의미 |
|---|---|
|
섀도 복사본 스토리지 영역 연결을 추가했습니다. |
|
호출자에게 충분한 백업 권한이 없거나 관리자가 아닙니다. |
|
매개 변수 값 중 하나가 잘못되었습니다. |
|
호출자가 메모리가 부족하거나 다른 시스템 리소스가 부족합니다. |
|
섀도 복사본 원본 볼륨에 최대 섀도 복사본 스토리지 영역 수가 추가되었습니다. 지정된 섀도 복사본 스토리지 볼륨이 지정된 섀도 복사본 원본 볼륨과 연결되지 않았습니다. |
|
지정된 볼륨이 너무 깊이 중첩되어 VSS 작업에 참여할 수 없습니다.
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 반환 코드는 지원되지 않습니다. |
|
pwszVolumeName과 pwszDiffAreaVolumeName 볼륨 간의 연결이 이미 있습니다. |
|
예상된 공급자 오류입니다. 공급자가 이벤트 로그에 오류를 기록했습니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요. |
|
예기치 않은 오류입니다. 오류 코드가 오류 로그 파일에 기록됩니다. 자세한 내용은 VSS에서 이벤트 및 오류 처리를 참조하세요.
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: 이 값은 Windows Server 2008 R2 및 Windows 7까지 지원되지 않습니다. 대신 E_UNEXPECTED 사용됩니다. |
|
pwszDiffAreaVolumeName 볼륨은 NTFS 볼륨이 아니거나 여유 공간이 부족합니다. |
설명
pwszVolumeName 볼륨에 대한 섀도 복사본이 이미 있거나 해당 볼륨에 대한 섀도 복사본 스토리지 영역 연결이 이미 있는 경우 섀도 복사본 스토리지 영역 연결을 만들 수 없습니다.
VHD(가상 하드 디스크) 원본 볼륨의 섀도 복사본 스토리지 영역은 동일한 볼륨에 있어야 합니다. 마찬가지로 원본 볼륨이 두 볼륨에 대해 동일한 경우에만 VHD 볼륨에 섀도 복사본 스토리지 영역을 만들 수 있습니다.
Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP: VHD는 지원되지 않습니다.
섀도 복사본 스토리지 영역의 크기를 변경하려면 IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize 또는 IVssDifferentialSoftwareSnapshotMgmt2::ChangeDiffAreaMaximumSizeEx 메서드를 사용합니다. 크기를 0으로 변경하여 섀도 복사본 스토리지 영역을 삭제할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | vsmgmt.h |