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

Un escritor llama al método OnBackupShutdown después de un evento BackupShutdown . Se usa para realizar operaciones que se consideran necesarias cuando se cierra una aplicación de copia de seguridad, especialmente en el caso de un bloqueo de la aplicación de copia de seguridad.

OnBackupShutdown es un método virtual. Se implementa mediante la clase base CVssWriter , pero se puede invalidar mediante clases derivadas.

Sintaxis

bool OnBackupShutdown(
  [in] VSS_ID SnapshotSetId
);

Parámetros

[in] SnapshotSetId

Identificador del conjunto de instantáneas implicado en la operación de copia de seguridad.

Valor devuelto

Como implementa la clase base, OnBackupShutdown siempre devuelve true.

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

La implementación predeterminada de este método por la clase base CVssWriter devuelve true sin realizar ninguna otra operación.

Si el escritor va a realizar operaciones especiales cuando se cierra una aplicación de copia de seguridad, se puede invalidar la implementación predeterminada.

Si no se ha realizado correctamente ninguna instantánea, el valor del identificador del conjunto de instantáneas (SnapshotSetId) será NULL.

Se generará un evento BackupShutdown cada vez que una aplicación de copia de seguridad finalice realmente y se liberen sus IVssBackupComponents .

El evento BackupComplete requiere que la aplicación de copia de seguridad complete correctamente la copia de seguridad o no se realice correctamente; Esto puede no ser el caso si el sistema finaliza la aplicación de copia de seguridad o finaliza manualmente antes de la finalización de la copia de seguridad (por ejemplo, si la operación de copia de seguridad se ha bloqueado y se ha tenido que apagar).

Por este motivo, un evento BackupShutdown es una señal más sólida del final de una aplicación de copia de seguridad que el evento BackupComplete .

Un escritor debe mantener la información de estado para que pueda realizar un seguimiento de si se envió un evento BackupComplete para un conjunto de instantáneas determinado.

Cualquier implementación específica del escritor de OnBackupShutdown debe comprobar si se controló un evento BackupComplete . Debe asegurarse de que todas las operaciones de limpieza del sistema de escritura necesarias después de una copia de seguridad (correcta o de lo contrario) estén preformadas.

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

Cliente mínimo compatible	Windows Vista [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::OnBackupComplete

CVssWriter::SetWriterFailure

IVssBackupComponents::BackupComplete