Compartilhar via


Método CVssWriter::OnBackupShutdown (vswriter.h)

O método OnBackupShutdown é chamado por um gravador após um evento BackupShutdown . Ele é usado para executar operações consideradas necessárias quando um aplicativo de backup é desligado, especialmente no caso de uma falha do aplicativo de backup.

OnBackupShutdown é um método virtual. Ele é implementado pela classe base CVssWriter , mas pode ser substituído por classes derivadas.

Sintaxe

bool OnBackupShutdown(
  [in] VSS_ID SnapshotSetId
);

Parâmetros

[in] SnapshotSetId

Identificador do conjunto de cópias de sombra envolvido na operação de backup.

Valor retornado

Conforme implementado pela classe base, OnBackupShutdown sempre retorna true

Qualquer outra 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

A implementação padrão desse método pela classe base CVssWriter retorna true sem executar nenhuma outra operação.

Se as operações especiais forem executadas pelo gravador quando um aplicativo de backup for desligado, a implementação padrão poderá ser substituída.

Se nenhuma cópia de sombra tiver sido executada com êxito, o valor do identificador do conjunto de cópias de sombra (SnapshotSetId) será NULL.

Um evento BackupShutdown será gerado sempre que um aplicativo de backup for realmente encerrado e seu IVssBackupComponents for lançado.

O evento BackupComplete requer que o aplicativo de backup conclua o backup com êxito ou falhe normalmente; isso pode não ser o caso se o aplicativo de backup for encerrado pelo sistema ou encerrado manualmente antes da conclusão do backup (por exemplo, se a operação de backup foi interrompida e teve que ser desligada).

Por isso, um evento BackupShutdown é um sinal mais robusto do final de um aplicativo de backup do que o evento BackupComplete .

Um gravador deve manter informações de estado para que possa acompanhar se um evento BackupComplete foi enviado para um determinado conjunto de cópias de sombra.

Qualquer implementação específica do gravador de OnBackupShutdown deve marcar se um evento BackupComplete foi tratado. Ele deve garantir que todas as operações de limpeza de gravador necessárias após um backup (bem-sucedido ou não) sejam pré-formadas.

Os gravadores nunca devem gerar uma exceção desse método ou de qualquer outro método de retorno de chamada CVssWriter(Ex)::OnXxx .

Se esse método chamar o método CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure ou CVssWriterEx2::SetWriterFailureEx , ele deverá fazê-lo no mesmo thread que chamou esse método. Para obter mais informações, consulte Tratamento de eventos do gravador.

Requisitos

   
Cliente mínimo com suporte Windows Vista [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

Confira também

CVssWriter

CVssWriter::OnBackupComplete

CVssWriter::SetWriterFailure

IVssBackupComponents::BackupComplete