Función JetTruncateLogInstance

Se aplica a: Windows | Windows Server

Función JetTruncateLogInstance

La función JetTruncateLogInstance se usa durante una copia de seguridad iniciada por JetBeginExternalBackup para eliminar los archivos de registro de transacciones que ya no serán necesarios una vez que la copia de seguridad actual se complete correctamente.

Windows XP:JetTruncateLogInstance se introduce en Windows XP.

    JET_ERR JET_API JetTruncateLogInstance(
      __in          JET_INSTANCE instance
    );

Parámetros

instance

Instancia 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.

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_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	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. Este error solo lo devolverá Windows XP y versiones posteriores.
JET_errInvalidBackupSequence	Error en la operación de copia de seguridad porque se llamó fuera de secuencia. JetTruncateLog devolverá este error si hay algún identificador de archivo pendiente que se haya creado con JetOpenFile para la instancia.
JET_errInvalidParameter	Uno de los parámetros proporcionados contenía un valor inesperado o la combinación de varios parámetros produjo un resultado inesperado. Esto puede ocurrir para JetTruncateLog cuando el identificador de instancia especificado no es válido.
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 esta función se realiza correctamente, se eliminará el conjunto de archivos de registro de transacciones que ya no serán necesarios una vez que se complete correctamente la copia de seguridad actual. La máquina de estado de copia de seguridad estará avanzada para que ya no se permita la copia de seguridad de los archivos de base de datos. Solo se permiten abrir archivos de revisión de base de datos y archivos de registro de transacciones para la copia de seguridad más allá de este punto.

Si se produce un error en esta función, la máquina de estado de copia de seguridad puede estar avanzada para que ya no se permita la copia de seguridad de los archivos de base de datos. Es posible que se elimine algún número de archivos de registro de transacciones que sea menor que el número deseado, pero siempre se eliminarán de más antiguo a más joven.

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

Archivos extensibles del motor de almacenamiento
JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetOpenFile
JetStopBackup
JetStopService