Share via

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로 고정되었습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값 의미
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 메서드를 사용합니다. 크기를 0으로 변경하여 섀도 복사본 스토리지 영역을 삭제할 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 vsmgmt.h

추가 정보

IVssDifferentialSoftwareSnapshotMgmt