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

Artículo
03/13/2024

Un escritor llama al método OnPreRestore después de un evento PreRestore . Este método se usa para colocar el escritor en un estado para admitir la restauración (por ejemplo, desconectar los servicios de base de datos) y para realizar modificaciones en el documento componentes de copia de seguridad del solicitante que está restaurando archivos (por ejemplo, establecer el destino de restauración para invalidar el método de restauración original).

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

Sintaxis

bool OnPreRestore(
  [in] IVssWriterComponents *pComponent
);

Parámetros

[in] pComponent

Puntero a una instancia de un objeto IVssWriterComponents que contiene los componentes asociados al escritor actual en el documento componentes de copia de seguridad del solicitante.

Valor devuelto

Como implementa la clase base, OnPreRestore 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

El evento PreRestore se produce antes de restaurar realmente los datos de copia de seguridad. Esta es una oportunidad para que el escritor determine lo que se está restaurando.

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

Este método permite al escritor determinar qué se está restaurando, recuperar metadatos privados almacenados en el documento componentes de copia de seguridad almacenados y actualizar esos 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