JetBeginExternalBackupInstance 函数

适用于： Windows |Windows Server

JetBeginExternalBackupInstance 函数在引擎和数据库联机且处于活动状态时启动外部备份。

Windows XP：JetBeginExternalBackupInstance 在 Windows XP 中引入。

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

instance

用于此调用的数据库实例。

对于 Windows 2000，接受此参数的 API 变体不可用，因为仅支持一个实例。在本例中隐含使用此全局实例。

对于 Windows XP 及更高版本，仅当引擎处于旧模式 (Windows 2000 兼容模式时，才可调用不接受此参数的 API 变体) 其中仅支持一个实例。否则，操作将失败并JET_errRunningInMultiInstanceMode。

grbit

指定以下零个或多个选项的一组位。

值	含义
JET_bitBackupAtomic	此标志已弃用。使用此位将导致返回JET_errInvalidgrbit。
JET_bitBackupIncremental	创建增量备份而不是完整备份。这意味着将仅备份自上次完整备份或增量备份以来的日志文件。
JET_bitBackupSnapshot	保留供将来使用。为 Windows XP 定义。

由于调用此函数，系统可能会生成成功或失败代码。有关此 API 错误的完整列表，请参阅可扩展存储引擎错误代码。

JetBeginExternalBackupInstance 是一系列函数中的第一个函数，必须调用这些函数才能成功执行联机 (基于非 VSS 的) 备份。另请参阅 JetBeginExternalBackup 和 JetStopBackupInstance。

外部备份可用于实现完整备份、增量备份或差异备份。

备份将是模糊的，这是因为备份将与事务历史记录中的单个时间点保持一致，但目前无法控制确切的时间点。

要求	值
客户端	需要 Windows Vista、Windows XP 或 Windows 2000 专业版。
服务器	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
标头	在 Esent.h 中声明。
Library	使用 ESENT.lib。
DLL	需要ESENT.dll。

反馈