Metodo CVssWriter::OnPrepareSnapshot (vswriter.h)

Articolo
03/03/2024

Il metodo OnPrepareSnapshot viene chiamato da un writer per gestire un evento PrepareForSnapshot . Viene usata per eseguire operazioni necessarie per preparare un writer a partecipare alla copia shadow o per assegnare un veto a una copia shadow.

OnPrepareSnapshot è un metodo virtuale puro. Non viene implementato dalla classe di base CVssWriter e deve essere implementato dalle classi derivate.

Sintassi

bool OnPrepareSnapshot();

Valore restituito

L'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

Il metodo OnPrepareSnapshot esegue operazioni necessarie prima di qualsiasi blocco della copia shadow.

La finestra di timeout per la gestione di un evento PrepareForSnapshot è in genere più lunga di quella per la gestione di un evento Freeze . Pertanto, gli sviluppatori possono usare OnPrepareSnapshot per gestire operazioni che richiedono più tempo. Un uso tipico potrebbe essere per il writer di checkpoint esplicito dei dati.

Gli autori non devono mai generare un'eccezione da questo metodo o da altri CVssWriter(Ex)::OnXxx metodo di callback.

Se questo metodo chiama il metodo CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure o CVssWriterEx2::SetWriterFailureEx , deve farlo nello stesso thread che ha chiamato questo metodo. Per altre informazioni, vedere Gestione degli 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::SetWriterFailure