Compartir a través de

Función JetBeginExternalBackupInstance

  • Artículo

Se aplica a: Windows | Windows Server

Función JetBeginExternalBackupInstance

La función JetBeginExternalBackupInstance inicia una copia de seguridad externa mientras el motor y la base de datos están en línea y activa.

Windows XP: JetBeginExternalBackupInstance se presenta en Windows XP.

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

Parámetros

instance

Instancia de base de datos que se va a usar para esta llamada.

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.

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.

Valor

Significado

JET_bitBackupAtomic

Esta marca está en desuso. El uso de este bit dará lugar a que se devuelva JET_errInvalidgrbit.

JET_bitBackupIncremental

Crea una copia de seguridad incremental en lugar de una copia de seguridad completa. Esto significa que solo se realizará una copia de seguridad de los archivos de registro desde la última copia de seguridad completa o incremental.

JET_bitBackupSnapshot

Reservado para uso futuro. Definido para Windows XP.

Valor devuelto

El sistema puede generar códigos de éxito o error como resultado de una llamada a esta función. Para obtener una lista completa de los errores de esta API, consulte Códigos de error del motor de almacenamiento extensible.

Consulte JetBeginExternalBackup.

Comentarios

JetBeginExternalBackupInstance es la primera función de una serie de funciones a las que se debe llamar para ejecutar una copia de seguridad correcta en línea (no basada en VSS). Consulte también JetBeginExternalBackup y JetStopBackupInstance.

Se puede usar una copia de seguridad externa para implementar copias de seguridad completas, incrementales o diferenciales.

La copia de seguridad será aproximada, en que la copia de seguridad será coherente con un único momento dado en el historial de transacciones, pero controlar el momento exacto en el tiempo no es posible en este momento.

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

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog