Click or drag to resize
IVssBackupComponentsIsVolumeSupported Method (String, Guid)
The IsVolumeSupported method determines whether the specified provider supports shadow copies on the specified volume.

Namespace: Alphaleonis.Win32.Vss
Assembly: AlphaVSS.Common (in AlphaVSS.Common.dll) Version: 1.3.0.0 (1.3.0.0)
Syntax
bool IsVolumeSupported(
	string volumeName,
	Guid providerId
)

Parameters

volumeName
Type: SystemString
Name of the volume. The name of the volume to be checked 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 (\)
providerId
Type: SystemGuid
Provider identifier. If the value is Empty, IsVolumeSupported(String, Guid) checks whether any provider supports the volume.

Return Value

Type: Boolean
if shadow copies are supported on the specified volume. If the value is , shadow copies are not supported on the specified volume.
Exceptions
ExceptionCondition
ArgumentNullExceptionvolumeName is
UnauthorizedAccessExceptionThe caller does not have sufficient backup privileges or is not an administrator.
OutOfMemoryExceptionOut of memory or other system resources.
SystemExceptionUnexpected VSS system error. The error code is logged in the event log.
VssBadStateExceptionThe backup components object is not initialized, this method has been called during a restore operation, or this method has not been called within the correct sequence.
VssObjectNotFoundExceptionThe specified volume was not found or was not available.
Remarks

IsVolumeSupported(String, Guid) will return if it is possible to create shadow copies on the given volume, even if the current configuration does not allow the creation of shadow copies on that volume at the present time.

For example, if the maximum number of shadow copies has been reached on a given volume (and therefore no more shadow copies can be created on that volume), the method will still indicate that the volume can be shadow copied.

See Also