Condividi tramite


Metodo CVssWriter::OnAbort (vswriter.h)

Il metodo OnAbort viene chiamato da un writer che segue un evento Abort emesso dal Servizio Copia Shadow che indica che un'operazione di copia shadow è stata terminata in modo anomalo. Il writer usa questo metodo per eseguire la pulizia dal tentativo di partecipare a tale operazione.

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

Sintassi

bool OnAbort();

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

In questo metodo, il writer deve liberare tutte le risorse di sistema temporanee create durante la preparazione per partecipare a un'operazione VSS.

Il writer non riceverà altre notifiche degli eventi correlate all'operazione VSS che ha partecipato dopo l'esecuzione di CVssWriter::OnAbort .

Questo metodo non verrà chiamato se il writer ha chiamato CVssWriter::OnPostSnapshot ,ovvero la notifica ricevuta della fine di una copia shadow.

Un evento Abort viene generato quando:

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

CVssWriter::OnFreeze

CVssWriter::OnPostSnapshot

CVssWriter::OnPrepareSnapshot

CVssWriter::OnThaw

CVssWriter::SetWriterFailure