CVssWriter class (vswriter.h)

The CVssWriter class is an abstract base class that defines the interface by which a writer synchronizes its state with VSS and other writers.

Every writer must instantiate an object derived from CVssWriter.

Objects derived from CVssWriter must supply implementations for all of the CVssWriter's pure virtual methods.

A writer can override one or all of CVssWriter's virtual methods.

To participate in VSS, a writer must first call CVssWriter::Initialize and then call CVssWriter::Subscribe.

A writer terminates its participation by calling CVssWriter::Unsubscribe.

The CVssWriter base class is responsible for the life cycle of interfaces passed to event handlers. This includes the following:

CVssWriter has these types of members:

Methods

The CVssWriter class has these methods.

 
CVssWriter::~CVssWriter

~CVssWriter is the destructor of the CVssWriter class object.
CVssWriter::AreComponentsSelected

The AreComponentsSelected method indicates whether a requester is running under component mode and supports selecting individual components to be backed up or backs up entire volumes.
CVssWriter::CVssWriter

CVssWriter is the constructor of the CVssWriter class object.
CVssWriter::GetBackupType

The GetBackupType method indicates the type of backup to be performed.
CVssWriter::GetContext

The GetContext information returns the current context for any ongoing or possible shadow copies.
CVssWriter::GetCurrentLevel

The GetCurrentLevel method returns the current application level.
CVssWriter::GetCurrentSnapshotSetId

The GetCurrentSnapshotSetId method returns the unique identifier of the shadow copy set.
CVssWriter::GetCurrentVolumeArray

The GetCurrentVolumeArray method returns the names of the original volumes and the UNC paths of the original remote file shares that belong to the shadow copy set as an array of null-terminated wide character strings.Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP and Windows Server 2003:  Remote file shares are not supported until Windows 8 and Windows Server 2012.
CVssWriter::GetCurrentVolumeCount

The GetCurrentVolumeCount method returns the number of volumes in the shadow copy set.
CVssWriter::GetRestoreType

The GetRestoreType method returns the type of restore a writer is participating in.
CVssWriter::GetSnapshotDeviceName

The GetSnapshotDeviceName method returns the name of the device that hosts the shadow copy of the specified volume or file share.
CVssWriter::Initialize

Initializes a CVssWriter object and allows a writer application to interact with VSS.
CVssWriter::InstallAlternateWriter

Not supported. (CVssWriter.InstallAlternateWriter)
CVssWriter::IsBootableSystemStateBackedUp

The IsBootableSystemStateBackedUp method indicates whether the bootable state will be backed up.
CVssWriter::IsPartialFileSupportEnabled

The IsPartialFileSupportEnabled method determines whether partial file support is enabled or disabled.
CVssWriter::IsPathAffected

The IsPathAffected method determines whether the specified directory or file is included in the current shadow copy set. The path for the directory or file can be a local path or a UNC path of a remote file share.
CVssWriter::OnAbort

The OnAbort method is called by a writer following an Abort event issued by VSS indicating that a shadow copy operation has terminated prematurely. The writer uses this method to clean up from its attempt to participate in that operation.
CVssWriter::OnBackOffIOOnVolume

Not supported. (CVssWriter.OnBackOffIOOnVolume)
CVssWriter::OnBackupComplete

The OnBackupComplete method is called by a writer following a BackupComplete event. It is used to perform operations considered necessary following a backup. These operations cannot, however, modify the Backup Components Document.
CVssWriter::OnBackupShutdown

The OnBackupShutdown method is called by a writer following a BackupShutdown event. It is used to perform operations considered necessary when a backup application shuts down, particularly in the case of a crash of the backup application.
CVssWriter::OnContinueIOOnVolume

Not supported. (CVssWriter.OnContinueIOOnVolume)
CVssWriter::OnFreeze

The OnFreeze method is called by a writer on receipt of a Freeze event at the start of a shadow copy freeze. A writer uses this method to perform operations needed to participate in the freeze or to veto the freeze.
CVssWriter::OnIdentify

The OnIdentify method is called by a writer following receipt of an Identify event.
CVssWriter::OnPostRestore

The OnPostRestore method is called by a writer following a PostRestore event. It is used to perform operations considered necessary after files are restored to disk by a requester. These operations cannot, however, modify the Backup Components Document.
CVssWriter::OnPostSnapshot

The OnPostSnapshot method is called by a writer following a PostSnapshot event.
CVssWriter::OnPrepareBackup

The OnPrepareBackup method is called by a writer following a PrepareForBackup event. This method is used to configure a writer's state and its components in preparation for a backup operation.
CVssWriter::OnPrepareSnapshot

The OnPrepareSnapshot method is called by a writer to handle a PrepareForSnapshot event. It is used to perform operations needed to prepare a writer to participate in the shadow copy or to veto a shadow copy.
CVssWriter::OnPreRestore

The OnPreRestore method is called by a writer following a PreRestore event.
CVssWriter::OnThaw

The OnThaw method is called by a writer following a Thaw event.
CVssWriter::OnVSSApplicationStartup

Not supported. (CVssWriter.OnVSSApplicationStartup)
CVssWriter::OnVSSShutdown

Not supported. (CVssWriter.OnVssShutdown)
CVssWriter::SetWriterFailure

The SetWriterFailure method indicates that this writer has encountered an error condition and sets an error condition.
CVssWriter::Subscribe

The Subscribe method subscribes the writer with VSS.
CVssWriter::Unsubscribe

The Unsubscribe method unsubscribes the writer with VSS.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header vswriter.h (include Vss.h, VsWriter.h)