Функция JetEndExternalBackupInstance

Статья
06/13/2023

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

Функция JetEndExternalBackupInstance

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

Windows XP: JetEndExternalBackupInstance представлен в Windows XP.

    JET_ERR JET_API JetEndExternalBackupInstance(
      __in          JET_INSTANCE instance
    );

Параметры

Экземпляр

Экземпляр, используемый для этого вызова.

Windows 2000: Для Windows 2000 вариант API, который принимает этот параметр, недоступен, так как поддерживается только один экземпляр. В данном случае подразумевается использование этого одного глобального экземпляра.

Windows XP: Для Windows XP и более поздних версий вариант API, который не принимает этот параметр, можно вызывать только в том случае, если подсистема находится в устаревшем режиме (режим совместимости Windows 2000), где поддерживается только один экземпляр. В противном случае операция завершится сбоем с JET_errRunningInMultiInstanceMode.

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

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

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

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

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

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

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

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

Требования

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

См. также:

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

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

Функция JetEndExternalBackupInstance