Función JetEndExternalBackupInstance2

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetEndExternalBackupInstance2

La función JetEndExternalBackupInstance2 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: JetEndExternalBackupInstance2 se presenta en Windows XP.

    JET_ERR JET_API JetEndExternalBackupInstance2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

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.

grbit

Un grupo de bits que especifica cero o más de las siguientes opciones.

Value	Significado
JET_bitBackupEndAbort 0x0002	La aplicación cliente está anulando la copia de seguridad.
JET_bitBackupEndNormal 0x0001	La aplicación cliente finalizó la copia de seguridad por completo y termina normalmente.
JET_bitBackupTruncateDone 0x0100	Windows Vista: JET_bitBackupTruncateDone se introduce en Windows Vista. El motor puede marcar los encabezados de base de datos según corresponda (por ejemplo, una copia de seguridad completa completada), aunque no se haya completado la llamada a truncar.

Value

Significado

JET_bitBackupEndAbort
0x0002

La aplicación cliente está anulando la copia de seguridad.

JET_bitBackupEndNormal
0x0001

La aplicación cliente finalizó la copia de seguridad por completo y termina normalmente.

JET_bitBackupTruncateDone
0x0100

Windows Vista: JET_bitBackupTruncateDone se introduce en Windows Vista.

El motor puede marcar los encabezados de base de datos según corresponda (por ejemplo, una copia de seguridad completa completada), aunque no se haya completado la llamada a truncar.

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 las 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
JET_ERR
JET_GRBIT
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog

Compartir a través de

Función JetEndExternalBackupInstance2