Функция JetEndExternalBackup

Статья
06/13/2023

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

Функция JetEndExternalBackup

Функция JetEndExternalBackup завершает сеанс внешнего резервного копирования. Эта функция является последним элементом API в ряде элементов API, которые необходимо вызвать для успешного выполнения оперативного резервного копирования (не на основе VSS).

    JET_ERR JET_API JetEndExternalBackup(void);

Параметры

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

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

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

Код возврата	Описание
JET_errSuccess	Операция выполнена успешно.
JET_errNotInitialized	Операция не может завершиться, так как экземпляр, связанный с сеансом, еще не инициализирован.
JET_errClientRequestToStopJetService	Операция не может завершиться, так как все действия экземпляра, связанного с сеансом, прекратились в результате вызова JetStopService.
JET_errInstanceUnavailable	Windows XP: Это возвращаемое значение появилось в Windows XP Операция не может завершиться, так как экземпляр, связанный с сеансом, столкнулся с неустранимой ошибкой, требующей отмены доступа ко всем данным для защиты целостности этих данных.
JET_errTermInProgress	Операция не может завершиться, так как экземпляр, связанный с сеансом, завершает работу.
JET_errRestoreInProgress	Операция не может завершиться, так как в экземпляре, связанном с сеансом, выполняется операция восстановления.
JET_errNoBackup	Операция завершилась сбоем, так как внешнее резервное копирование не выполняется.
JET_errBackupAbortByServer	Windows Server 2003: Это возвращаемое значение появилось в Windows Server 2003. Операция завершилась сбоем, так как текущая внешняя резервная копия была прервана вызовом JetStopBackup.
errBackupAbortByCaller	Windows XP: Это возвращаемое значение появилось в Windows XP. Вызывающий объект завершил резервное копирование в середине последовательности резервного копирования, не сигналив о намерении с помощью JetStopBackup. Эта ошибка является результатом ошибки в клиенте резервного копирования в Windows Server 2003 и более поздних версиях. В Windows XP эта ошибка возвращается для преднамеренного завершения внешней последовательности резервного копирования.
JET_errRunningInMultiInstanceMode	Операция завершилась сбоем, так как была предпринята попытка использовать подсистему в устаревшем режиме (режим совместимости с Windows 2000), где поддерживается только один экземпляр, хотя на самом деле уже существует несколько экземпляров.

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

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

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

Дополнительные сведения о внешней последовательности API резервного копирования см. в разделе JetBeginExternalBackup.

До Windows Vista, если усечение журнала не было выполнено, подсистема считала резервное копирование резервной копией. Однако резервное копирование может быть обычным резервным копированием, для которого не было выполнено усечение (например, при наличии отсоединяемых баз данных). Параметр JET_bitBackupTruncateDone можно использовать для информирования подсистемы об этом и разрешения соответствующих изменений заголовков базы данных.

Требования

Требование	Значение
Клиент	Требуется Windows Vista, Windows XP или Windows 2000 Professional.
Сервер	Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.
Верхняя часть	Объявлено в Esent.h.
Библиотека	Используйте ESENT.lib.
DLL	Требуется ESENT.dll.

См. также:

Параметры обработки ошибок
Ошибки подсистемы расширяемого хранилища
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog

Поделиться через

Функция JetEndExternalBackup