Metodo CVssWriter::OnAbort (vswriter.h)

Articolo
08/27/2023

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:

I gestori eventi Freeze e Thaw di un writer (CVssWriter::OnFreeze e CVssWriter::OnThaw) restituiscono false oppure non possono essere completati nell'intervallo di tempo specificato in CVssWriter::Initialize.
Un richiedente genera in modo esplicito un evento Abort chiamando IVssBackupComponents::AbortBackup.
Si è verificato un errore del provider o del Servizio Copia Shadow del servizio Copia Shadow durante la creazione di una copia shadow dopo l'evento PrepareForSnapshot .

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