大网数据广告活动
磁盘与文件系统

JetBeginExternalBackupInstance Function

· 52CE 我爱测

Learn more about: JetBeginExternalBackupInstance Function

Applies to: Windows | Windows Server

JetBeginExternalBackupInstance Function

The JetBeginExternalBackupInstance function initiates an external backup while the engine and database are online and active.

Windows XP:  JetBeginExternalBackupInstance is introduced in Windows XP.

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

Parameters

instance

The database instance to use for this call.

For Windows 2000, the API variant that accepts this parameter is not available because only one instance is supported. The use of this one global instance is implied in this case.

For Windows XP and later releases, the API variant that does not accept this parameter may only be called when the engine is in legacy mode (Windows 2000 compatibility mode) where only one instance is supported. Otherwise, the operation will fail with JET_errRunningInMultiInstanceMode.

grbit

A group of bits specifying zero or more of the following options.

Value Meaning
JET_bitBackupAtomic This flag is deprecated. Usage of this bit will result in JET_errInvalidgrbit being returned.
JET_bitBackupIncremental Creates an incremental backup as opposed to a full backup. This means that only the log files since the last full or incremental backup will be backed up.
JET_bitBackupSnapshot Reserved for future use. Defined for Windows XP.

Return Value

The system may generate success or failure codes as a result of a call to this function. For a complete list of errors for this API, see Extensible Storage Engine Error Codes.

See JetBeginExternalBackup.

Remarks

JetBeginExternalBackupInstance is the first function in a series of functions that must be called to execute a successful online (non-VSS based) backup. See also JetBeginExternalBackup and JetStopBackupInstance.

An external backup can be used to implement full, incremental, or differential backups.

The backup will be fuzzy, in that the backup will be consistent to a single point in time in the transaction history, but controlling the exact point in time is not possible at this time.

Requirements
Requirement Value
Client Requires Windows Vista, Windows XP, or Windows 2000 Professional.
Server Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.
Header Declared in Esent.h.
Library Use ESENT.lib.
DLL Requires ESENT.dll.
See Also

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

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 04/11/2016
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。