Metodo IVssComponent::GetAdditionalRestores (vswriter.h)

  • Articolo

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
S_OK
 Restituito correttamente il valore dell'attributo.
S_FALSE
 L'attributo specificato non ha un valore.
E_INVALIDARG
 Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY
 Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT
 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

Vedi anche

IVssComponent