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


Функция JetBeginExternalBackupInstance

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

Функция JetBeginExternalBackupInstance

Функция JetBeginExternalBackupInstance инициирует внешнее резервное копирование, когда ядро и база данных находятся в сети и активны.

Windows XP: JetBeginExternalBackupInstance появилось в Windows XP.

    JET_ERR JET_API JetBeginExternalBackupInstance(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Параметры

Экземпляр

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

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

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

grbit

Группа битов, задающая ноль или несколько следующих параметров.

Значение

Значение

JET_bitBackupAtomic

Этот флаг не рекомендуется использовать. Использование этого бита приведет к возврату JET_errInvalidgrbit.

JET_bitBackupIncremental

Создает добавочную резервную копию, а не полную. Это означает, что резервные копии будут создаваться только для файлов журнала с момента последней полной или добавочной резервной копии.

JET_bitBackupSnapshot

Зарезервировано для последующего использования. Определяется для Windows XP.

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

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

См. раздел JetBeginExternalBackup.

Комментарии

JetBeginExternalBackupInstance — это первая функция в серии функций, которую необходимо вызвать для успешного выполнения оперативного резервного копирования (не на основе VSS). См. также Статьи JetBeginExternalBackup и JetStopBackupInstance.

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

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

Требования

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

Клиент

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

Сервер

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

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

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

Библиотека

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

DLL

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

См. также:

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog