Método CVssWriter::OnPrepareSnapshot (vswriter.h)
O método OnPrepareSnapshot é chamado por um gravador para manipular um evento PrepareForSnapshot . Ele é usado para executar operações necessárias para preparar um gravador para participar da cópia de sombra ou para vetar uma cópia de sombra.
OnPrepareSnapshot é um método virtual puro. Ele não é implementado pela classe base CVssWriter e deve ser implementado por classes derivadas.
Sintaxe
bool OnPrepareSnapshot();
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
O método OnPrepareSnapshot executa operações que são necessárias antes de qualquer congelamento de cópia de sombra.
A janela de tempo limite para lidar com um evento PrepareForSnapshot normalmente é maior do que a para lidar com um evento Freeze . Portanto, os desenvolvedores podem usar OnPrepareSnapshot para lidar com operações mais demoradas. Um uso típico pode ser para o gravador verificar explicitamente seus dados.
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
| 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 |