Metodo IVssComponent::SetBackupStamp (vswriter.h)
Il metodo SetBackupStamp imposta una stringa contenente informazioni che indicano quando è stato eseguito un backup.
Un writer può chiamare questo metodo solo durante un'operazione di backup.
Questo metodo non può essere chiamato durante la gestione di un evento BackupComplete (CVssWriter::OnBackupComplete) o BackupShutdown (CVssWriter::OnBackupShutdown).
Sintassi
HRESULT SetBackupStamp(
[in] LPCWSTR wszBackupStamp
);
Parametri
[in] wszBackupStamp
Informazioni sulla stringa di caratteri wide con terminazione null che indicano quando è stato eseguito un backup.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
Valore | Significato |
---|---|
|
Impostare correttamente il timestamp di backup. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
Questo metodo non è stato chiamato da un writer o, se chiamato da un writer, non è stato chiamato durante un'operazione di backup o è stato chiamato durante la gestione di un evento BackupComplete o BackupShutdown. |
Commenti
Per altre informazioni sui stamp di backup, vedere Ruolo writer in Backup di archivi complessi.
Il timbro di backup impostato da SetBackupStamp si applica a tutti i file nel componente e a qualsiasi sottocomponente non selezionabile che ha.
I writer chiamano in genere SetBackupStamp durante la gestione di un evento PostSnapshot in CVssWriter::OnPostSnapshot.
I richiedenti archiviano semplicemente il timbro di backup nel documento Componenti di backup. Non usano direttamente il timbro di backup o devono sapere come interpretarlo.
L'unico uso del timbro di backup eseguito da un richiedente, durante un'operazione di ripristino, consiste nel rendere disponibile la stringa timestamp archiviata per un writer usando il metodo IVssBackupComponents::SetPreviousBackupStamp .
Per questo motivo, non esistono restrizioni di formato sul contenuto del timbro di backup. Può contenere informazioni sull'ora e sulla data, numeri di sequenza logica o qualsiasi altra informazione che consentirà a un writer della stessa classe di determinare quando è stato eseguito l'ultimo backup.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | vswriter.h (include Vss.h, VsWriter.h) |
Libreria | VssApi.lib |