Método CVssWriter::OnAbort (vswriter.h)
O método OnAbort é chamado por um gravador após um evento Abort emitido pelo VSS indicando que uma operação de cópia de sombra foi encerrada prematuramente. O gravador usa esse método para limpo de sua tentativa de participar dessa operação.
OnAbort é um método virtual puro. Ele não é implementado pela classe base CVssWriter e deve ser implementado por classes derivadas.
Sintaxe
bool OnAbort();
Retornar valor
A implementação desse método deve retornar true , exceto no caso de um erro fatal. Se ocorrer um erro fatal, o método deverá chamar o método CVssWriter::SetWriterFailure para fornecer uma descrição da falha antes de retornar false. Se ocorrer um erro não fatal, o método ainda deverá chamar SetWriterFailure , mas retornar true. Se o erro for causado por um problema transitório, o método deverá especificar VSS_E_WRITERERROR_RETRYABLE na chamada para SetWriterFailure.
Em todos os casos em que ocorre uma falha, o método deve gravar um evento no log de eventos para relatar o motivo exato da falha.
Comentários
Nesse método, o gravador deve liberar todos os recursos temporários do sistema que criou ao se preparar para participar de uma operação vss.
O gravador não receberá mais notificações de evento relacionadas à operação vss em que estava participando depois que CVssWriter::OnAbort tiver sido executado.
Esse método não será chamado se o gravador tiver chamado CVssWriter::OnPostSnapshot (ou seja, recebeu notificação do final de uma cópia de sombra).
Um evento Abort é gerado quando:
- Os manipuladores de eventos Freeze e Thaw de um gravador (CVssWriter::OnFreeze e CVssWriter::OnThaw) retornam false ou não podem ser concluídos na janela de tempo especificada em CVssWriter::Initialize.
- Um solicitante gera explicitamente um evento Abort chamando IVssBackupComponents::AbortBackup.
- Há qualquer falha do provedor ou vss durante a criação de uma cópia de sombra após o evento PrepareForSnapshot .
Se esse método chamar o método CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure ou CVssWriterEx2::SetWriterFailureEx , ele deverá fazer isso no mesmo thread que chamou esse método. Para obter mais informações, consulte Tratamento de eventos do gravador.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vswriter.h (inclua Vss.h, VsWriter.h) |
| Biblioteca | VssApi.lib |