Функция JetTruncateLog

  • Статья

Применимо к: Windows | Windows Server

Функция JetTruncateLog

Функция JetTruncateLog используется во время резервного копирования, инициированного JetBeginExternalBackup , чтобы удалить все файлы журнала транзакций, которые больше не потребуются после успешного завершения текущей резервной копии.

    JET_ERR JET_API JetTruncateLog(void);

Параметры

У этой функции нет параметров.

Возвращаемое значение

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

JET_errBackupAbortByServer

Операция завершилась сбоем, так как текущая внешняя резервная копия была прервана вызовом JetStopBackup.

Windows Server 2003: Это возвращаемое значение появилось в Windows Server 2003.

JET_errClientRequestToStopJetService

Операция не может завершиться, так как все действия экземпляра, связанного с сеансом, прекратились в результате вызова JetStopService.

JET_errInstanceUnavailable

Операция не может завершиться, так как экземпляр, связанный с сеансом, столкнулся с неустранимой ошибкой, требующей отмены доступа ко всем данным для защиты целостности этих данных.

Windows XP: Это возвращаемое значение появилось в Windows XP.

JET_errInvalidBackupSequence

Операция резервного копирования завершилась сбоем, так как она была вызвана из последовательности. JetTruncateLog вернет эту ошибку, если есть какие-либо необработанные дескрипторы файлов, созданные с помощью JetOpenFile для экземпляра.

JET_errInvalidParameter

Один из предоставленных параметров содержал непредвиденное значение или сочетание нескольких параметров приводило к неожиданному результату. Это может произойти для JetTruncateLog , если указанный дескриптор экземпляра недопустим.

Windows XP: Это возвращаемое значение появилось в Windows XP.

JET_errNoBackup

Операция завершилась сбоем, так как внешнее резервное копирование не выполняется.

JET_errNotInitialized

Операция не может завершиться, так как экземпляр, связанный с сеансом, еще не инициализирован.

JET_errRestoreInProgress

Операция не может завершиться, так как в экземпляре, связанном с сеансом, выполняется операция восстановления.

JET_errRunningInMultiInstanceMode

Операция завершилась сбоем, так как была предпринята попытка использовать подсистему в устаревшем режиме (режим совместимости с Windows 2000), где поддерживается только один экземпляр, хотя на самом деле уже существует несколько экземпляров.

JET_errTermInProgress

Операция не может завершиться, так как экземпляр, связанный с сеансом, завершает работу.

Если эта функция будет выполнена успешно, набор файлов журнала транзакций, которые больше не понадобятся после успешного завершения текущей резервной копии, будут удалены. Конечный компьютер резервного копирования будет расширен таким образом, что резервное копирование файлов базы данных больше не разрешено. После этого можно открывать для резервного копирования только файлы исправлений базы данных и файлы журналов транзакций.

Если эта функция завершается сбоем, конечный компьютер резервного копирования может быть расширен таким образом, что резервное копирование файлов базы данных больше не разрешено. Может быть удалено некоторое количество файлов журнала транзакций, которое меньше требуемого числа, но они всегда будут удаляться от старых к младшим.

Требования

Требование Значение

Клиент

Требуется Windows Vista, Windows XP или Windows 2000 Professional.

Сервер

Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.

Верхняя часть

Объявлено в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

См. также:

Расширяемые файлы подсистемы хранилища
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService