Metodo IVssComponent::SetBackupStamp (vswriter.h)

  • Articolo

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
S_OK
 Impostare correttamente il timestamp di backup.
E_INVALIDARG
 Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
 Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE
 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

Vedi anche

IVssComponent

IVssComponent::GetBackupStamp