Metodo CVssWriter::OnPreRestore (vswriter.h)

Il metodo OnPreRestore viene chiamato da un writer che segue un evento PreRestore . Questo metodo viene usato per inserire il writer in uno stato per supportare il ripristino, ad esempio l'esecuzione di servizi di database offline e per apportare modifiche nel documento Componenti di backup del richiedente che sta ripristinando i file, ad esempio impostando la destinazione di ripristino per eseguire l'override del metodo di ripristino originale.

OnPreRestore è un metodo virtuale. Viene implementato dalla classe di base CVssWriter , ma può essere sottoposto a override da classi derivate.

Sintassi

bool OnPreRestore(
  [in] IVssWriterComponents *pComponent
);

Parametri

[in] pComponent

Puntatore a un'istanza di un oggetto IVssWriterComponents contenente tali componenti associati al writer corrente nel documento Componenti di backup del richiedente.

Valore restituito

Come implementato dalla classe base, OnPreRestore restituisce sempre true.

Qualsiasi altra implementazione di questo metodo deve restituire true tranne nel caso di un errore irreversibile. Se si verifica un errore irreversibile, il metodo deve chiamare il metodo CVssWriter::SetWriterFailure per fornire una descrizione dell'errore prima di restituire false. Se si verifica un errore non irreversibile, il metodo deve comunque chiamare SetWriterFailure ma restituire true. Se l'errore è causato da un problema temporaneo, il metodo deve specificare VSS_E_WRITERERROR_RETRYABLE nella chiamata a SetWriterFailure.

In tutti i casi in cui si verifica un errore, il metodo deve scrivere un evento nel registro eventi per segnalare il motivo esatto dell'errore.

Commenti

L'evento PreRestore si verifica prima del ripristino dei dati di backup. Si tratta di un'opportunità per il writer di determinare cosa viene ripristinato.

L'implementazione predefinita di questo metodo da parte della classe di base CVssWriter restituisce true senza eseguire alcuna altra operazione.

Questo metodo consente al writer di determinare cosa viene ripristinato, di recuperare i metadati privati archiviati nel documento dei componenti di backup archiviati e di aggiornare tali dati.

I writer non devono mai generare un'eccezione da questo metodo o da qualsiasi altro metodo CVssWriter(Ex)::OnXxx callback.

Se questo metodo chiama il metodo CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure o CVssWriterEx2::SetWriterFailureEx , deve farlo nello stesso thread denominato questo metodo. Per altre informazioni, vedere Gestione eventi writer.

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

CVssWriter

CVssWriter::OnPostSnapshot

CVssWriter::OnPrepareBackup

CVssWriter::SetWriterFailure

IVssWriterComponents