Click or drag to resize

IVssBackupComponentsPrepareForBackup Method

The PrepareForBackup method will cause VSS to generate a PrepareForBackup event, signaling writers to prepare for an upcoming backup operation. This makes a requester's Backup Components Document available to writers.

Namespace:  Alphaleonis.Win32.Vss
Assembly:  AlphaVSS.Common (in AlphaVSS.Common.dll) Version: 1.4.0.0 (1.4.0.0)
Syntax
void PrepareForBackup()
Exceptions
ExceptionCondition
UnauthorizedAccessExceptionThe caller does not have sufficient backup privileges or is not an administrator.
OutOfMemoryExceptionOut of memory or other system resources.
SystemExceptionUnexpected VSS system error. The error code is logged in the event log.
VssBadStateExceptionThe backup components object is not initialized, this method has been called during a restore operation, or this method has not been called within the correct sequence.
Remarks

PrepareForBackup generates a PrepareForBackup event, which is handled by each instance of each writer through the CVssWriter::OnPrepareBackup method.

Before PrepareForBackup can be called, SetBackupState(Boolean, Boolean, VssBackupType, Boolean) must be called.

See Also