Export (0) Print
Expand All

IVssComponent::SetBackupStamp method

The SetBackupStamp method sets a string containing information indicating when a backup took place.

A writer can call this method only during a backup operation.

This method cannot be called while handling a BackupComplete (CVssWriter::OnBackupComplete) or BackupShutdown (CVssWriter::OnBackupShutdown) event.

Syntax


HRESULT SetBackupStamp(
  [in]  LPCWSTR wszBackupStamp
);

Parameters

wszBackupStamp [in]

Null-terminated wide character string information indicating when a backup took place.

Return value

The following are the valid return codes for this method.

ValueMeaning
S_OK

Successfully set the backup time stamp.

E_INVALIDARG

One of the parameter values is not valid.

E_OUTOFMEMORY

The caller is out of memory or other system resources.

VSS_E_BAD_STATE

This method was not called by a writer or, if called by a writer, it either was not called during a backup operation or was called while handling a BackupComplete or BackupShutdown event.

 

Remarks

For more information about backup stamps, see Writer Role in Backing Up Complex Stores.

The backup stamp set by SetBackupStamp applies to all files in the component and any nonselectable subcomponents it has.

Writers typically call SetBackupStamp while handling a PostSnapshot event in CVssWriter::OnPostSnapshot.

Requesters merely store the backup stamp in the Backup Components Document. They do not make direct use of the backup stamp or have to know how to interpret it.

The only use of the backup stamp that a requester makes, during a restore operation, is to make the stored time-stamp string available to a writer by using the IVssBackupComponents::SetPreviousBackupStamp method.

For this reason, there are no format restrictions on the content of the backup stamp. It may contain time and date information, logical sequence numbers, or any other information that will allow a writer of the same class to determine when the last backup has taken place.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

VsWriter.h (include Vss.h or VsWriter.h)

Library

VssApi.lib

See also

IVssComponent
IVssComponent::GetBackupStamp

 

 

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft