Función JetTruncateLog

Se aplica a: Windows | Windows Server

Función JetTruncateLog

La función JetTruncateLog 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.

    JET_ERR JET_API JetTruncateLog(void);

Parámetros

Esta función no tiene parámetros.

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	Error en la operación porque la copia de seguridad externa actual se ha anulado mediante una llamada a JetStopBackup. Windows Server 2003: Este valor devuelto se introduce en Windows Server 2003.
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 ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos. Windows XP: Este valor devuelto se introduce en Windows XP.
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. Windows XP: Este valor devuelto se introduce en Windows XP.
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, 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

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