IVssComponent::GetPreviousBackupStamp method (vswriter.h)
The GetPreviousBackupStamp method returns a previous backup stamp loaded by a requester in the Backup Components Document. The value is used by a writer when deciding if files should participate in differential or incremental backup operation.
Either a writer or a requester can call this method.
HRESULT GetPreviousBackupStamp( [out] BSTR *pbstrBackupStamp );
Pointer to a string containing the time stamp of a previous backup so that a differential or incremental backup can be correctly implemented.
The following are the valid return codes for this method.
||Successfully returned the attribute value.|
||No previous backup time stamp has been set.|
||One of the parameter values is not valid.|
||The caller is out of memory or other system resources.|
||The XML document is not valid. Check the event log for details. For more information, see Event and Error Handling Under VSS.|
The caller should free the memory held by the pbstrBackupStamp parameter by calling SysFreeString.
If there is no previous backup time stamp, GetPreviousBackupStamp returns S_FALSE.
The string returned refers to all files in the component and any nonselectable subcomponents it has.
The backup stamp retrieved by GetPreviousBackupStamp is set by a requester using IVssBackupComponents::SetPreviousBackupStamp.
Typically, the string used to set the value found by GetPreviousBackupStamp was retrieved from a stored Backup Components Document or was stored by the requester as part of its own internal records.
|Minimum supported client||Windows XP [desktop apps only]|
|Minimum supported server||Windows Server 2003 [desktop apps only]|
|Header||vswriter.h (include Vss.h, VsWriter.h)|