Función JetEndExternalBackupInstance
Se aplica a: Windows | Windows Server
Función JetEndExternalBackupInstance
La función JetEndExternalBackupInstance finaliza una sesión de copia de seguridad externa. Esta API es la última API de una serie de API a las que se debe llamar para ejecutar una copia de seguridad en línea correcta (no basada en VSS).
Windows XP: JetEndExternalBackupInstance se presenta en Windows XP.
JET_ERR JET_API JetEndExternalBackupInstance(
__in JET_INSTANCE instance
);
Parámetros
instance
Instancia que se va a usar para esta llamada.
Windows 2000: Para Windows 2000, la variante de API que acepta este parámetro no está disponible porque solo se admite una instancia. El uso de esta instancia global está implícito en este caso.
Windows XP: Para Windows XP y versiones posteriores, la variante de API que no acepta este parámetro solo se puede llamar cuando el motor está en modo heredado (modo de compatibilidad de Windows 2000), donde solo se admite una instancia. De lo contrario, se producirá un error en la operación con JET_errRunningInMultiInstanceMode.
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_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_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. |
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_errNoBackup |
Error en la operación porque no hay ninguna copia de seguridad externa en curso. |
JET_errNotInitialized |
La operación no se puede completar porque la instancia asociada a la sesión aún no se ha inicializado. |
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_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. |
JET_errTermInProgress |
La operación no se puede completar porque la instancia asociada a la sesión se está cerrando. |
Si la 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.
Comentarios
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 modificaciones adecuadas del encabezado de base de datos.
Requisitos
| Requisito | Value |
|---|---|
Cliente |
Requiere Windows Vista o Windows XP. |
Servidor |
Requiere Windows Server 2008 o Windows Server 2003. |
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
JetBeginExternalBackupInstance
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog