_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,
  VSS_SS_PREPARING,
  VSS_SS_PROCESSING_PREPARE,
  VSS_SS_PREPARED,
  VSS_SS_PROCESSING_PRECOMMIT,
  VSS_SS_PRECOMMITTED,
  VSS_SS_PROCESSING_COMMIT,
  VSS_SS_COMMITTED,
  VSS_SS_PROCESSING_POSTCOMMIT,
  VSS_SS_PROCESSING_PREFINALCOMMIT,
  VSS_SS_PREFINALCOMMITTED,
  VSS_SS_PROCESSING_POSTFINALCOMMIT,
  VSS_SS_CREATED,
  VSS_SS_ABORTED,
  VSS_SS_DELETED,
  VSS_SS_POSTCOMMITTED,
  VSS_SS_COUNT
} 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

IVssBackupComponents::GetSnapshotProperties

IVssBackupComponents::Query

IVssEnumObject

VSS_OBJECT_PROP

VSS_OBJECT_UNION

VSS_SNAPSHOT_PROP