Share via

IVssDifferentialSoftwareSnapshotMgmt::ChangeDiffAreaMaximumSize 메서드(vsmgmt.h)

  • 아티클

ChangeDiffAreaMaximumSize 메서드는 특정 볼륨의 섀도 복사본 스토리지 영역 최대 크기를 업데이트합니다. 이는 즉각적인 영향을 미치지 않을 수 있습니다.

구문

HRESULT ChangeDiffAreaMaximumSize(
  [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

볼륨에 사용할 섀도 복사본 스토리지 영역의 최대 크기(바이트)를 지정합니다. 이 값이 0이면 섀도 복사본 스토리지 영역이 삭제됩니다. 이 값이 –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 메서드를 사용합니다.

요구 사항

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

추가 정보

IVssDifferentialSoftwareSnapshotMgmt