JetEndExternalBackup 函式

適用于： Windows |Windows Server

JetEndExternalBackup 函式

JetEndExternalBackup函式會結束外部備份會話。 此函式是一系列 API 元素中的最後一個 API 元素，必須呼叫才能在線上執行成功的線上 (非 VSS 型) 備份。

    JET_ERR JET_API JetEndExternalBackup(void);

參數

此函式沒有參數。

傳回值

此函式會傳回具有下列其中一個傳回碼 的JET_ERR 資料類型。 如需可能 ESE 錯誤的詳細資訊，請參閱 可延伸的儲存引擎錯誤 和 錯誤處理參數。

傳回碼	Description
JET_errSuccess	作業已成功完成。
JET_errNotInitialized	作業無法完成，因為尚未初始化與會話相關聯的實例。
JET_errClientRequestToStopJetService	作業無法完成，因為與會話相關聯的實例上的所有活動都因為對 JetStopService的呼叫而停止。
JET_errInstanceUnavailable	Windowsxp： Windows XP 中引進此傳回值 作業無法完成，因為與會話相關聯的實例發生嚴重錯誤，需要撤銷所有資料的存取權，以保護該資料的完整性。
JET_errTermInProgress	作業無法完成，因為與會話相關聯的實例正在關閉。
JET_errRestoreInProgress	作業無法完成，因為與會話相關聯的實例上正在進行還原作業。
JET_errNoBackup	作業失敗，因為沒有任何外部備份正在進行中。
JET_errBackupAbortByServer	Windows Server 2003： 此傳回值會在 Windows Server 2003 中引進。 作業失敗，因為對 JetStopBackup的呼叫已中止目前的外部備份。
errBackupAbortByCaller	Windowsxp： 此傳回值會在 Windows XP 中引進。 呼叫端在備份順序中間終止備份，而不會向 JetStopBackup發出意圖的訊號。 此錯誤是 Windows Server 2003 和更新版本中備份用戶端發生錯誤的結果。 在 Windows XP 上，會針對外部備份順序的刻意終止傳回此錯誤。
JET_errRunningInMultiInstanceMode	作業失敗，因為嘗試在舊版模式中使用引擎， (Windows 2000 相容性模式) 其中僅支援一個實例，但事實上有多個實例已存在。

如果此函式成功，外部備份就會成功。 成功表示從備份引擎擷取適用于 JetBeginExternalBackup) 中所指定備份 (類型的資料庫和) 記錄檔 (所有檔案。 備份的檔案可以使用硬式復原來復原， (JetExternalRestore) 。

如果此函式失敗，外部備份通常會結束。 失敗表示備份因用戶端或應用程式使用錯誤而無效。 請務必檢查此 API 的傳回碼，以確認備份順序是否成功。

備註

如果引擎設定為記錄事件，則會記錄事件以指出外部備份的解析。

如果備份順序未完成，且成功呼叫 JetEndExternalBackup，後續的增量備份可能會包含比應用程式預期的更多資料。

如需外部備份 API 順序的詳細資訊，請參閱 JetBeginExternalBackup。

在 Windows Vista 之前，如果記錄截斷未完成，引擎會將備份視為複本備份。 不過，如果已中斷連結的資料庫) ，備份可能是未完成截斷的一般備份 (。 JET_bitBackupTruncateDone選項可用來通知引擎有關此情況，並允許修改適當的資料庫標頭。

規格需求

需求	值
用戶端	需要 Windows Vista、Windows XP 或 Windows 2000 Professional。
Server	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
標頭	在 Esent.h 中宣告。
程式庫	使用 ESENT.lib。
Dll	需要ESENT.dll。

另請參閱

錯誤處理參數
可延伸儲存引擎錯誤
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog