Función JetEndExternalBackup

Se aplica a: Windows | Windows Server

Función JetEndExternalBackup

La función JetEndExternalBackup finaliza una sesión de copia de seguridad externa. Esta función es el último elemento de API de una serie de elementos de API a los que se debe llamar para ejecutar una copia de seguridad en línea correcta (no basada en VSS).

    JET_ERR JET_API JetEndExternalBackup(void);

Parámetros

Esta función no tiene parámetros.

Valor devuelto

Esta función devuelve el JET_ERR tipo de datos con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errNotInitialized	La operación no se puede completar porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errClientRequestToStopJetService	La operación no se puede completar porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a JetStopService.
JET_errInstanceUnavailable	Windows XP: Este valor devuelto se introduce en Windows XP La operación no se puede completar porque la instancia asociada a la sesión encontró un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos.
JET_errTermInProgress	La operación no se puede completar porque la instancia asociada a la sesión se está cerrando.
JET_errRestoreInProgress	La operación no se puede completar porque hay una operación de restauración en curso en la instancia asociada a la sesión.
JET_errNoBackup	Error en la operación porque no hay ninguna copia de seguridad externa en curso.
JET_errBackupAbortByServer	Windows Server 2003: Este valor devuelto se introduce en Windows Server 2003. Error en la operación porque la copia de seguridad externa actual se ha anulado mediante una llamada a JetStopBackup.
errBackupAbortByCaller	Windows XP: Este valor devuelto se introduce en Windows XP. El autor de la llamada terminó una copia de seguridad en medio de la secuencia de copia de seguridad sin indicar la intención con JetStopBackup. Este error es el resultado de un error en el cliente de copia de seguridad en Windows Server 2003 y versiones posteriores. En Windows XP, este error se devuelve para una terminación intencionada de la secuencia de copia de seguridad externa.
JET_errRunningInMultiInstanceMode	Error en la operación porque se intentó usar el motor en modo heredado (modo de compatibilidad de Windows 2000), donde solo se admite una instancia, cuando de hecho ya existen varias instancias.

Si esta función se realiza correctamente, la copia de seguridad externa se realizó correctamente. Correcto indica que todos los archivos (por ejemplo, bases de datos y registros) que son adecuados para el tipo de copia de seguridad (especificado en JetBeginExternalBackup) se recuperaron del motor de copia de seguridad. Los archivos de copia de seguridad se pueden recuperar con recuperación dura (JetExternalRestore).

Si se produce un error en esta función, la copia de seguridad externa suele finalizar. Error significa que la copia de seguridad no es válida debido a un cliente o a un error de uso de la aplicación. Es importante comprobar el código de retorno de esta API para comprobar que la secuencia de copia de seguridad se realizó correctamente.

Observaciones

Si el motor está configurado para registrar eventos, se registra un evento para indicar la resolución de la copia de seguridad externa.

Si la secuencia de copia de seguridad no se completa en orden y con una llamada correcta a JetEndExternalBackup, las copias de seguridad incrementales posteriores podrían contener más datos de los previstos por la aplicación.

Para obtener más información sobre la secuencia de API de copia de seguridad externa, consulte JetBeginExternalBackup.

Antes de Windows Vista, si no se realizó el truncamiento del registro, el motor consideró que la copia de seguridad era una copia de seguridad. Sin embargo, la copia de seguridad podría ser una copia de seguridad normal para la que no se realizó el truncamiento (por ejemplo, si hay bases de datos desasociadas). La opción JET_bitBackupTruncateDone se puede usar para informar al motor sobre esto y permitir las modificaciones adecuadas del encabezado de base de datos.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.

Consulte también

Parámetros de control de errores
Errores del motor de almacenamiento extensible
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog