Función JetExternalRestore2

Artículo
06/13/2023

Se aplica a: Windows | Windows Server

Función JetExternalRestore2

La función JetExternalRestore2 restaura una copia de seguridad externa que se realizó con las API de copia de seguridad externas y proporciona puntos de control para las operaciones de registro circulares. Esto se conoce como recuperación dura, que es similar pero diferente de la recuperación temporal que realiza la función JetInit .

Windows XP: JetExternalRestore2 se introduce en Windows XP.

    JET_ERR JET_API JetExternalRestore2(
      __in          JET_PSTR szCheckpointFilePath,
      __in          JET_PSTR szLogPath,
      __in_opt      JET_RSTMAP* rgrstmap,
      __in          long crstfilemap,
      __in          JET_PSTR szBackupLogPath,
      __in_out      JET_LOGINFO* pLogInfo,
      __in_opt      JET_PSTR szTargetInstanceName,
      __in_opt      JET_PSTR szTargetInstanceLogPath,
      __in_opt      JET_PSTR szTargetInstanceCheckpointPath,
      __in          JET_PFNSTATUS pfn
    );

Parámetros

szCheckpointFilePath

Ruta de acceso del archivo de punto de comprobación que se va a usar durante la recuperación si no se especifica szTargetInstanceCheckpointPath o esa ruta de acceso tiene una instancia activa o en ejecución.

szLogPath

Ruta de acceso o directorio de los registros de la fase final (deshacer) de la recuperación y posiblemente para los registros de puesta al día. Esta ruta de acceso puede ser la misma que szBackupLogPath.

rgrstmap

Se trata de una matriz de estructuras de JET_RSTMAP . Se trata de un mapa de rutas de acceso o nombres de base de datos antiguos y nuevos. Esto se usa porque es posible que las bases de datos deban recuperarse en una ubicación distinta de la ubicación desde la que se ha hecho una copia de seguridad. En el caso de que se adjunte varias bases de datos a un único conjunto de registro, el mapa de restauración puede especificar un subconjunto de las bases de datos que se van a restaurar.

crstfilemap

Número de entradas en el parámetro de matriz rgrstmap .

szBackupLogPath

Ruta de acceso al directorio donde se restauran los archivos de registro. Estos son los registros que se leyeron durante la secuencia de copia de seguridad externa. Esta ruta de acceso puede ser la misma que szLogPath.

pLogInfo

PLogInfo describe varios aspectos de los registros de copia de seguridad para la recuperación, este parámetro permite a JetExternalRestore2 tomar los parámetros explícitos genLow y genHigh que tiene JetExternalRestore2, así como el nombre del registro base, en lugar de un nombre base de registro supuesto de "edb".

szTargetInstanceName

Este parámetro está en desuso y no se puede usar en la aplicación.

szTargetInstanceLogPath

La ruta de acceso de los registros de puesta al día si la ubicación de los registros que desea implementar se encuentran en un conjunto de registro activo o una instancia. No se debe especificar si la instancia de destino usa el registro circular.

szTargetInstanceCheckpointPath

Ruta de acceso del punto de control durante la recuperación si no hay ninguna instancia activa que se ejecute en este destino. No se debe especificar si la instancia de destino usa el registro circular.

pfn

Devolución de llamada de estado, que informa del progreso de la recuperación.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR 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_errBadRestoreTargetInstance	El valor de szTargetInstanceLogPath especificado no pertenece a una instancia inicializada. Este error solo se devolverá en Windows XP y versiones posteriores.
JET_errDatabaseCorrupted	Esto indica que la base de datos estaba dañada o un archivo no reconocido.
JET_errEndingRestoreLogTooLow	Este error se devuelve si uno de los archivos de registro de szBackupLogPath tiene una generación de registros anterior que se especificó en genHigh o pLogInfo.ulGenHigh.
JET_errFileNotFound	Error en la operación porque no se pudo abrir el archivo solicitado porque no se encontró en la ruta de acceso especificada.
JET_errInvalidParameter	Uno de los parámetros proporcionados contenía un valor inesperado o contenía un valor que no tenía sentido cuando se combinaba con el valor de otro parámetro. Esto puede ocurrir para JetExternalRestore, etc. cuando szTargetCheckpointPath y szTargetInstanceLogPath no se especifican o no ambos no se especifican. Es decir, deben coincidir y ser especificados o no especificados.
JET_errInvalidPath	Error en la operación porque no se encontró la ruta de acceso especificada.
JET_errOutOfMemory	Error en la operación porque no se pudo asignar suficiente memoria para completarla.
JET_errRestoreOfNonBackupDatabase	Este error se devuelve si el archivo de base de datos especificado durante la restauración no es una base de datos de la que se ha realizado una copia de seguridad con una copia de seguridad externa.
JET_errRunningInOneInstanceMode	El motor de base de datos no puede ejecutar la restauración externa ni la recuperación en modo de instancia única. Este error solo se devolverá en Windows XP y versiones posteriores.
JET_errStartingRestoreLogTooHigh	Este error se devuelve si uno de los archivos de registro de szBackupLogPath tiene una generación de registros por debajo de la especificada por genLow o pLogInfo.ulGenLow.

Si se ejecuta correctamente, todas las bases de datos del mapa rgrstmap se recuperan completamente y tienen un estado limpio o coherente. En este momento, la base de datos se puede volver a montar en una instancia existente.

En caso de error, el motor no pudo recuperar la base de datos. La base de datos está en un estado no válido y para volver a intentar la recuperación completa de la base de datos debe restaurarse de nuevo. Normalmente, el origen de esta situación es daños en el disco o en el registro, o en algún otro tipo de administración incorrecta del registro o en un conjunto de registros no continuo.

Comentarios

Consulte JetExternalRestore.

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.
Unicode	Se implementa como JetExternalRestore2W (Unicode) y JetExternalRestore2A (ANSI).

Consulte también

JET_ERR
JET_LOGINFO
JET_PFNSTATUS
JET_RSTMAP
JetBeginExternalBackup
JetExternalRestore
JetInit

Compartir a través de

Función JetExternalRestore2