Metodo IVssBackupComponents::SetAdditionalRestores (vsbackup.h)
Il metodo SetAdditionalRestores viene usato da un richiedente durante operazioni di ripristino incrementale o differenziale per indicare ai writer che un determinato componente richiederà operazioni di ripristino aggiuntive per recuperarlo completamente.
Sintassi
HRESULT SetAdditionalRestores(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bAdditionalRestores
);
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 da aggiungere.
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.
Non esistono restrizioni sui caratteri che possono essere visualizzati in un percorso logico non NULL .
[in] wszComponentName
Stringa di caratteri wide con terminazione Null contenente il nome del componente.
Il valore della stringa non deve essere NULL e deve contenere lo stesso componente usato quando il componente è stato aggiunto al set di backup usando IVssBackupComponents::AddComponent.
[in] bAdditionalRestores
Se il valore di questo parametro è true, i ripristini aggiuntivi del componente seguiranno questo ripristino. Se il valore è false, i ripristini aggiuntivi del componente non seguiranno questo ripristino.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Impostare correttamente lo stato di ripristino aggiuntivo. |
|
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
Le informazioni fornite dal metodo SetAdditionalRestores vengono in genere usate dai writer che supportano un meccanismo di recupero esplicito come parte del gestore eventi PostRestore (CVssWriter::OnPostRestore), ad esempio le applicazioni di Exchange Server e di database, ad esempio SQL Server. Per queste applicazioni, spesso non è possibile eseguire ripristini differenziali, incrementali o di log aggiuntivi dopo l'esecuzione di tale ripristino.
Pertanto, se SetAdditionalRestores per un componente è impostato su true, ciò significa che tale writer non deve eseguire il meccanismo di recupero esplicito e dovrebbe prevedere che verranno eseguiti ripristini differenziali, incrementali o di log aggiuntivi.
Quando SetAdditionalRestores in un componente è impostato su false, dopo il ripristino del componente, l'applicazione può completare l'operazione di ripristino e essere ripristinata online.
Questo metodo deve essere chiamato prima di IVssBackupComponents::P reRestore.
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 |