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

Artigo
08/27/2023

O método OnThaw é chamado por um gravador após um evento Thaw .

OnThaw é um método virtual puro. Ele não é implementado pela classe base CVssWriter e deve ser implementado por classes derivadas.

Sintaxe

bool OnThaw();

Valor retornado

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

Esse método é chamado no final de um congelamento de cópia de sombra quando os gravadores podem começar a modificar dados no disco novamente.

OnThaw é usado para retornar o gravador à operação normal, normalmente revertendo ações executadas durante CVssWriter::OnPrepareSnapshot e CVssWriter::OnFreeze.

As atualizações finais do gravador para os metadados e a limpeza dos componentes de backup (como a remoção de arquivos temporários) normalmente são reservadas para CVssWriter::OnPostSnapshot.

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