VSS_SNAPSHOT_STATE

VSS_SNAPSHOT_STATE enumeration

The VSS_SNAPSHOT_STATE enumeration is returned by a provider to specify the state of a given shadow copy operation.

Syntax


typedef enum _VSS_SNAPSHOT_STATE { 
  VSS_SS_UNKNOWN                     = 0x00,
  VSS_SS_PREPARING                   = 0x01,
  VSS_SS_PROCESSING_PREPARE          = 0x02,
  VSS_SS_PREPARED                    = 0x03,
  VSS_SS_PROCESSING_PRECOMMIT        = 0x04,
  VSS_SS_PRECOMMITTED                = 0x05,
  VSS_SS_PROCESSING_COMMIT           = 0x06,
  VSS_SS_COMMITTED                   = 0x07,
  VSS_SS_PROCESSING_POSTCOMMIT       = 0x08,
  VSS_SS_PROCESSING_PREFINALCOMMIT   = 0x09,
  VSS_SS_PREFINALCOMMITTED           = 0x0a,
  VSS_SS_PROCESSING_POSTFINALCOMMIT  = 0x0b,
  VSS_SS_CREATED                     = 0x0c,
  VSS_SS_ABORTED                     = 0x0d,
  VSS_SS_DELETED                     = 0x0e,
  VSS_SS_POSTCOMMITTED               = 0x0f,
  VSS_SS_COUNT                       = 0x10
} VSS_SNAPSHOT_STATE, *PVSS_SNAPSHOT_STATE;

Constants

VSS_SS_UNKNOWN

Reserved for system use.

Unknown shadow copy state.

VSS_SS_PREPARING

Reserved for system use.

Shadow copy is being prepared.

VSS_SS_PROCESSING_PREPARE

Reserved for system use.

Processing of the shadow copy preparation is in progress.

VSS_SS_PREPARED

Reserved for system use.

Shadow copy has been prepared.

VSS_SS_PROCESSING_PRECOMMIT

Reserved for system use.

Processing of the shadow copy precommit is in process.

VSS_SS_PRECOMMITTED

Reserved for system use.

Shadow copy is precommitted.

VSS_SS_PROCESSING_COMMIT

Reserved for system use.

Processing of the shadow copy commit is in process.

VSS_SS_COMMITTED

Reserved for system use.

Shadow copy is committed.

VSS_SS_PROCESSING_POSTCOMMIT

Reserved for system use.

Processing of the shadow copy postcommit is in process.

VSS_SS_PROCESSING_PREFINALCOMMIT

Reserved for system use.

Processing of the shadow copy file commit operation is underway.

VSS_SS_PREFINALCOMMITTED

Reserved for system use.

Processing of the shadow copy file commit operation is done.

VSS_SS_PROCESSING_POSTFINALCOMMIT

Reserved for system use.

Processing of the shadow copy following the final commit and prior to shadow copy create is underway.

VSS_SS_CREATED

Shadow copy is created.

VSS_SS_ABORTED

Reserved for system use.

Shadow copy creation is aborted.

VSS_SS_DELETED

Reserved for system use.

Shadow copy has been deleted.

VSS_SS_POSTCOMMITTED
VSS_SS_COUNT

Reserved value.

Remarks

The shadow copy state is contained in the m_eStatus member of a VSS_SNAPSHOT_PROP object, which can be obtained for a single shadow copy by calling IVssBackupComponents::GetSnapshotProperties.

Because IVssBackupComponents::GetSnapshotProperties fails during shadow copy creation with VSS_E_OBJECT_NOT_FOUND, a requester cannot obtain any VSS_SNAPSHOT_STATE value other than VSS_SS_CREATED.

Calls to IVssBackupComponents::Query can also be used to obtain the shadow copy state. IVssBackupComponents::Query is used to return lists of shadow copies, which may be iterated over by means of the IVssEnumObject interface to obtain VSS_SNAPSHOT_PROP objects for each shadow copy that have completed on a given system. This means that, like IVssBackupComponents::GetSnapshotProperties, the IVssBackupComponents::Query method can return only a shadow copy state of VSS_SS_CREATED.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Vss.h

See also

VSS_SNAPSHOT_PROP
VSS_OBJECT_UNION
VSS_OBJECT_PROP
IVssBackupComponents::GetSnapshotProperties
IVssBackupComponents::Query
IVssEnumObject

 

 

Show:
© 2016 Microsoft