VSS_PROTECTION_FAULT enumeration

Defines the set of shadow copy protection faults. A shadow copy protection fault occurs when the VSS service is unable to perform a copy-on-write operation to the shadow copy storage area (also called the diff area).

Syntax


typedef enum _VSS_PROTECTION_FAULT { 
  VSS_PROTECTION_FAULT_NONE                          = 0,
  VSS_PROTECTION_FAULT_DIFF_AREA_MISSING             = ( VSS_PROTECTION_FAULT_NONE + 1 ),
  VSS_PROTECTION_FAULT_IO_FAILURE_DURING_ONLINE      = ( VSS_PROTECTION_FAULT_DIFF_AREA_MISSING + 1 ),
  VSS_PROTECTION_FAULT_META_DATA_CORRUPTION          = ( VSS_PROTECTION_FAULT_IO_FAILURE_DURING_ONLINE + 1 ),
  VSS_PROTECTION_FAULT_MEMORY_ALLOCATION_FAILURE     = ( VSS_PROTECTION_FAULT_META_DATA_CORRUPTION + 1 ),
  VSS_PROTECTION_FAULT_MAPPED_MEMORY_FAILURE         = ( VSS_PROTECTION_FAULT_MEMORY_ALLOCATION_FAILURE + 1 ),
  VSS_PROTECTION_FAULT_COW_READ_FAILURE              = ( VSS_PROTECTION_FAULT_MAPPED_MEMORY_FAILURE + 1 ),
  VSS_PROTECTION_FAULT_COW_WRITE_FAILURE             = ( VSS_PROTECTION_FAULT_COW_READ_FAILURE + 1 ),
  VSS_PROTECTION_FAULT_DIFF_AREA_FULL                = ( VSS_PROTECTION_FAULT_COW_WRITE_FAILURE + 1 ),
  VSS_PROTECTION_FAULT_GROW_TOO_SLOW                 = ( VSS_PROTECTION_FAULT_DIFF_AREA_FULL + 1 ),
  VSS_PROTECTION_FAULT_GROW_FAILED                   = ( VSS_PROTECTION_FAULT_GROW_TOO_SLOW + 1 ),
  VSS_PROTECTION_FAULT_DESTROY_ALL_SNAPSHOTS         = ( VSS_PROTECTION_FAULT_GROW_FAILED + 1 ),
  VSS_PROTECTION_FAULT_FILE_SYSTEM_FAILURE           = ( VSS_PROTECTION_FAULT_DESTROY_ALL_SNAPSHOTS + 1 ),
  VSS_PROTECTION_FAULT_IO_FAILURE                    = ( VSS_PROTECTION_FAULT_FILE_SYSTEM_FAILURE + 1 ),
  VSS_PROTECTION_FAULT_DIFF_AREA_REMOVED             = ( VSS_PROTECTION_FAULT_IO_FAILURE + 1 ),
  VSS_PROTECTION_FAULT_EXTERNAL_WRITER_TO_DIFF_AREA  = ( VSS_PROTECTION_FAULT_DIFF_AREA_REMOVED + 1 )
} VSS_PROTECTION_FAULT;

Constants

VSS_PROTECTION_FAULT_NONE

No shadow copy protection fault has occurred.

VSS_PROTECTION_FAULT_DIFF_AREA_MISSING

The volume that contains the shadow copy storage area could not be found. Usually this fault means that the volume has not yet arrived in the system.

VSS_PROTECTION_FAULT_IO_FAILURE_DURING_ONLINE

The volume that contains the shadow copy storage area could not be brought online because an I/O failure occurred.

VSS_PROTECTION_FAULT_META_DATA_CORRUPTION

The shadow copy metadata for the shadow copy storage area has been corrupted.

VSS_PROTECTION_FAULT_MEMORY_ALLOCATION_FAILURE

A memory allocation failure occurred. This could be caused by a temporary low-memory condition that does not happen again after you clear the fault and restart the shadow copy operation.

VSS_PROTECTION_FAULT_MAPPED_MEMORY_FAILURE

A memory mapping failure occurred. This fault could mean that the page file is too small, or it could be caused by a low-memory condition.

VSS_PROTECTION_FAULT_COW_READ_FAILURE

A read failure occurred during the copy-on-write operation when data was being copied from the live volume to the shadow copy storage area volume.

VSS_PROTECTION_FAULT_COW_WRITE_FAILURE

A read or write failure occurred during the copy-on-write operation when data was being copied from the live volume to the shadow copy storage area volume. One possible reason is that the shadow copy storage area volume has been removed from the system.

VSS_PROTECTION_FAULT_DIFF_AREA_FULL

This failure means that either the shadow copy storage area is full or the shadow copy storage area volume is full. After clearing the protection fault, you can do one of the following:

VSS_PROTECTION_FAULT_GROW_TOO_SLOW

The size of the shadow copy storage area could not be increased because there was no longer enough space on the shadow copy storage area volume.

VSS_PROTECTION_FAULT_GROW_FAILED

The size of the shadow copy storage area could not be increased.

VSS_PROTECTION_FAULT_DESTROY_ALL_SNAPSHOTS

An unexpected error occurred.

VSS_PROTECTION_FAULT_FILE_SYSTEM_FAILURE

Either the shadow copy storage area files could not be opened or the shadow copy storage area volume could not be mounted because of a file system operation failure.

VSS_PROTECTION_FAULT_IO_FAILURE

A read or write failure occurred on the shadow copy storage area volume.

VSS_PROTECTION_FAULT_DIFF_AREA_REMOVED

The shadow copy storage area volume was removed from the system or could not be accessed for some other reason.

VSS_PROTECTION_FAULT_EXTERNAL_WRITER_TO_DIFF_AREA

Another application attempted to write to the shadow copy storage area.

Requirements

Minimum supported client

Windows Vista with SP1 [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

VsMgmt.h

See also

IVssDifferentialSoftwareSnapshotMgmt3::ClearVolumeProtectFault
VSS_PROTECTION_FAULT
VSS_VOLUME_PROTECTION_INFO

 

 

Show: