Metodo IVssComponent::GetAdditionalRestores (vswriter.h)
Il metodo GetAdditionalRestores viene usato da un writer durante operazioni di ripristino incrementali o differenziali per determinare se un determinato componente richiederà operazioni di ripristino aggiuntive per recuperarlo completamente.
Un writer o un richiedente può chiamare questo metodo.
Sintassi
HRESULT GetAdditionalRestores(
[out] bool *pbAdditionalRestores
);
Parametri
[out] pbAdditionalRestores
Indirizzo di una variabile allocata dal chiamante che riceve true se si verificheranno ripristini aggiuntivi per il componente corrente o false in caso contrario.
Valore restituito
Di seguito sono riportati i codici restituiti validi per questo metodo.
| Valore | Significato |
|---|---|
|
Restituito correttamente il valore dell'attributo. |
|
L'attributo specificato non ha un valore. |
|
Uno dei valori dei parametri non è valido. |
|
Il chiamante non è in memoria o altre risorse di sistema. |
|
Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
Commenti
Il valore restituito da GetAdditionalRestores sarà false, a meno che durante un'operazione di ripristino un richiedente chiami IVssBackupComponents::SetAdditionalRestores.
GetAdditionalRestores deve essere usato per verificare se è necessario usare più di un set di backup per ripristinare completamente un componente. Un componente può essere recuperato prima ripristinando i dati da un backup completo e quindi aggiornando i dati da uno o più backup incrementali o differenziali successivi.
Il metodo GetAdditionalRestores viene in genere usato dai writer che supportano un meccanismo di ripristino 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 log aggiuntivi dopo l'esecuzione di tale ripristino.
Pertanto, se GetAdditionalRestores restituisce true per un componente, tale writer non deve eseguire il meccanismo di ripristino esplicito e dovrebbe prevedere che verranno eseguiti altri ripristini differenziali, incrementali o log.
Quando SetAdditionalRestores restituisce false, quindi dopo aver completato il ripristino, quando si gestisce l'evento PostRestore , il writer può completare l'operazione di ripristino e tornare online.
Requisiti
| 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 |