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

Un escritor llama al método OnPrepareSnapshot para controlar un evento PrepareForSnapshot . Se usa para realizar operaciones necesarias para preparar un escritor para participar en la instantánea o para vetar una instantánea.

OnPrepareSnapshot es un método virtual puro. La clase base CVssWriter no la implementa y debe implementarse mediante clases derivadas.

Sintaxis

bool OnPrepareSnapshot();

Valor devuelto

La implementación de este método debe devolver true , excepto en el caso de un error irrecuperable. Si se produce un error irrecuperable, el método debe llamar al método CVssWriter::SetWriterFailure para proporcionar una descripción del error antes de devolver false. Si se produce un error nofatal, el método debe llamar a SetWriterFailure pero devolver true. Si el error se debe a un problema transitorio, el método debe especificar VSS_E_WRITERERROR_RETRYABLE en la llamada a SetWriterFailure.

En todos los casos en los que se produce un error, el método debe escribir un evento en el registro de eventos para notificar el motivo exacto del error.

Comentarios

El método OnPrepareSnapshot realiza operaciones necesarias antes de inmovilizar cualquier instantánea.

La ventana de tiempo de espera para controlar un evento PrepareForSnapshot suele ser más larga que para controlar un evento Freeze . Por lo tanto, los desarrolladores pueden usar OnPrepareSnapshot para controlar más operaciones que consumen mucho tiempo. Un uso típico podría ser para que el escritor controle explícitamente sus datos.

Los escritores nunca deben iniciar una excepción de este método ni de ningún otro CVssWriter(Ex)::OnXxx método de devolución de llamada.

Si este método llama al método CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure o CVssWriterEx2::SetWriterFailureEx , debe hacerlo en el mismo subproceso que llamó a este método. Para obtener más información, vea Writer Event Handling.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vswriter.h (incluye Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

CVssWriter

CVssWriter::OnAbort

CVssWriter::OnFreeze

CVssWriter::OnThaw

CVssWriter::SetWriterFailure