共用方式為


JetBeginExternalBackupInstance 函式

適用于: Windows |Windows Server

JetBeginExternalBackupInstance 函式

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 和更新版本,只有在引擎處於舊版模式時,才能呼叫不接受此參數的 API 變體, (Windows 2000 相容性模式) 只支援一個實例。 否則,作業將會因為JET_errRunningInMultiInstanceMode而失敗。

grbit

指定下列選項之零或多個位群組。

意義

JET_bitBackupAtomic

此旗標已被取代。 使用這個位會導致傳回JET_errInvalidgrbit。

JET_bitBackupIncremental

建立增量備份,而不是完整備份。 這表示只會備份上次完整備份或增量備份後的記錄檔。

JET_bitBackupSnapshot

保留供未來使用。 為 Windows XP 定義。

傳回值

系統可能會因為呼叫此函式而產生成功或失敗代碼。 如需此 API 錯誤的完整清單,請參閱 可延伸儲存引擎錯誤碼

請參閱 JetBeginExternalBackup

備註

JetBeginExternalBackupInstance 是一系列函式中的第一個函式,必須呼叫才能在線上執行成功的線上 (非 VSS 型) 備份。 另請參閱 JetBeginExternalBackupJetStopBackupInstance

外部備份可用來實作完整、增量或差異備份。

備份會模糊,也就是說,備份會與交易歷程記錄中的單一時間點一致,但目前無法控制確切的時間點。

規格需求

需求

用戶端

需要 Windows Vista、Windows XP 或 Windows 2000 Professional。

Server

需要 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