Metodo IVssBackupComponents::SetPreviousBackupStamp (vsbackup.h)
Il metodo SetPreviousBackupStamp imposta lo stamp di backup di un'operazione di backup precedente, su cui verrà basata un'operazione di backup differenziale o incrementale.
Il metodo può essere chiamato solo durante un'operazione di backup.
Sintassi
HRESULT SetPreviousBackupStamp(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] LPCWSTR wszPreviousBackupStamp
);
Parametri
[in] writerId
Identificatore del writer.
[in] ct
Tipo del componente. Vedere VSS_COMPONENT_TYPE per i valori possibili.
[in] wszLogicalPath
Stringa di caratteri wide con terminazione Null contenente il percorso logico del componente.
Per altre informazioni, vedere Percorso logico dei componenti.
Il valore della stringa contenente il percorso logico usato qui deve corrispondere a quello usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.
Il percorso logico può essere NULL.
[in] wszComponentName
Stringa di caratteri wide con terminazione Null contenente il nome del componente.
La stringa non può essere NULL e deve contenere lo stesso nome del componente usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.
[in] wszPreviousBackupStamp
Timbro di backup da impostare.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Impostare correttamente il timestamp di backup precedente. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino oppure questo metodo non è stato chiamato all'interno della sequenza corretta. |
|
Il componente di backup non esiste. |
|
Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato. |
Commenti
Questo metodo deve essere chiamato prima di IVssBackupComponents::P repareForBackup.
Solo i richiedenti possono chiamare questo metodo.
Il timbro di backup impostato da SetPreviousBackupStamp si applica a tutti i file nel componente e a tutti i sottocomponenti non selezionabili di cui dispone.
I richiedenti archiviano semplicemente i timbri di backup nel documento Componenti di backup. Non possono usare direttamente i francobolli di backup, non conoscerne il formato e non sanno come generarli.
Di conseguenza, il valore impostato con SetPreviousBackupStamp deve essere recuperato dal documento dei componenti di backup archiviati di un'operazione di backup precedente (usando IVssComponent::GetBackupStamp per il componente corretto) o dalle informazioni archiviate dal richiedente nei propri record interni.
Un writer otterrà quindi questo valore (usando IVssComponent::GetPreviousBackupStamp) e potrà contrassegnare i file appropriati per la partecipazione a un backup incrementale o differenziale.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h) |
| Libreria | VssApi.lib |