適用于: 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 錯誤的完整清單,請參閱 可延伸儲存引擎錯誤碼。
備註
JetBeginExternalBackupInstance 是一系列函式中的第一個函式,必須呼叫才能在線上執行成功的線上 (非 VSS 型) 備份。 另請參閱 JetBeginExternalBackup 和 JetStopBackupInstance。
外部備份可用來實作完整、增量或差異備份。
備份會模糊,也就是說,備份會與交易歷程記錄中的單一時間點一致,但目前無法控制確切的時間點。
規格需求
| 需求 | 值 |
|---|---|
用戶端 |
需要 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