IVssDifferentialSoftwareSnapshotMgmt3::SetVolumeProtectLevel method (vsmgmt.h)

Sets the shadow copy protection level for an original volume or a shadow copy storage area volume.

Syntax

HRESULT SetVolumeProtectLevel(
  [in] VSS_PWSZ             pwszVolumeName,
  [in] VSS_PROTECTION_LEVEL protectionLevel
);

Parameters

[in] pwszVolumeName

The name of the volume. This parameter is required and cannot be NULL.

The name must be in one of the following formats and must include a trailing backslash (\):

• The path of a mounted folder, for example, Y:\MountX\
• A drive letter, for example, D:\
• A volume GUID path in the form \\?\Volume{GUID}\ (where GUID identifies the volume)

[in] protectionLevel

A value from the VSS_PROTECTION_LEVEL enumeration that specifies the shadow copy protection level.

Return value

The following are the valid return codes for this method.

Remarks

The SetVolumeProtectLevel method checks the current shadow copy protection level of the volume. If the volume is in a faulted state and VSS_PROTECTION_LEVEL_ORIGINAL_VOLUME is specified for the protectionLevel parameter, SetVolumeProtectLevel dismounts the volume before setting the protection level.

If the current protection level of the volume is the same as the value of the protectionLevel parameter, SetVolumeProtectLevel does nothing.

If the value of the protectionLevel parameter is VSS_PROTECTION_LEVEL_SNAPSHOT, requesters must set shadow copy storage area (diff area) associations using the IVssDifferentialSoftwareSnapshotMgmt::AddDiffArea method.

Requirements

See also

IVssDifferentialSoftwareSnapshotMgmt3

IVssDifferentialSoftwareSnapshotMgmt3::GetVolumeProtectLevel