Функция 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