Click or drag to resize

IVssDifferentialSoftwareSnapshotManagementChangeDiffAreaMaximumSize Method (String, String, Int64, Boolean)

The ChangeDiffAreaMaximumSize Overload method updates the shadow copy storage area maximum size for a certain volume. This may not have an immediate effect.

Namespace:  Alphaleonis.Win32.Vss
Assembly:  AlphaVSS.Common (in AlphaVSS.Common.dll) Version: 1.4.0.0 (1.4.0.0)
Syntax
void ChangeDiffAreaMaximumSize(
	string volumeName,
	string diffAreaVolumeName,
	long maximumDiffSpace,
	bool isVolatile
)

Parameters

volumeName
Type: SystemString

Name of the volume that is the source of shadow copies that are associated with a shadow copy storage area on the diffAreaVolumeName volume.

The name of the volume must be in one of the following formats:

  • The path of a volume mount point with a backslash (\)
  • A drive letter with backslash (\), for example, D:\
  • A unique volume name of the form \\?\Volume{GUID}\ (where GUID is the unique global identifier of the volume) with a backslash (\)

diffAreaVolumeName
Type: SystemString

Name of the volume that contains the shadow copy storage area associated with the volumeName volume.

The name of the volume must be in one of the following formats:

  • The path of a volume mount point with a backslash (\)
  • A drive letter with backslash (\), for example, D:\
  • A unique volume name of the form \\?\Volume{GUID}\ (where GUID is the unique global identifier of the volume) with a backslash (\)

maximumDiffSpace
Type: SystemInt64
Specifies the maximum size, in bytes, for the shadow copy storage area to use for the volume. If this value is zero, the shadow copy storage area will be disabled.
isVolatile
Type: SystemBoolean

to indicate that the effect of calling the ChangeDiffAreaMaximumSize Overload method should not continue if the computer is rebooted; otherwise, .

If the maximumDiffSpace parameter is zero, the isVolatile parameter must be .

Exceptions
ExceptionCondition
UnauthorizedAccessExceptionCaller does not have sufficient backup privileges or is not an administrator.
OutOfMemoryExceptionThe caller is out of memory or other system resources.
ArgumentExceptionOne of the parameter values is not valid.
ArgumentNullExceptionOne of the arguments was
SystemExceptionUnexpected error. The error code is logged in the error log file.
VssObjectNotFoundExceptionThe association between the volumeName and diffAreaVolumeName volumes was not found.
VssProviderVetoExceptionExpected provider error. The provider logged the error in the event log.
VssInsufficientStorageExceptionThe diffAreaVolumeName volume does not have sufficient free space.
VssVolumeInUseExceptionA shadow copy is currently using the shadow copy storage area.
See Also