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

Artículo
03/09/2024

Un escritor llama al método OnAbort después de un evento Abort emitido por VSS que indica que una operación de instantánea ha finalizado prematuramente. El escritor usa este método para limpiar de su intento de participar en esa operación.

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

Sintaxis

bool OnAbort();

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

En este método, el escritor debe liberar todos los recursos temporales del sistema que creó al prepararse para participar con una operación de VSS.

El escritor no recibirá más notificaciones de eventos relacionadas con la operación de VSS en la que participaba después de que se haya ejecutado CVssWriter::OnAbort .

No se llamará a este método si el escritor ha llamado a CVssWriter::OnPostSnapshot (es decir, se recibe una notificación del final de una instantánea).

Se genera un evento Abort cuando:

Los controladores de eventos Freeze y Thaw de un escritor (CVssWriter::OnFreeze y CVssWriter::OnThaw) devuelven false o no se pueden completar en el período de tiempo especificado en CVssWriter::Initialize.
Un solicitante genera explícitamente un evento Abort llamando a IVssBackupComponents::AbortBackup.
Hay algún error del proveedor o VSS durante la creación de una instantánea después del evento PrepareForSnapshot .

Los escritores nunca deben producir una excepción de este método o cualquier 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 (incluya Vss.h, VsWriter.h)
Library	VssApi.lib