JetStopBackup 函式

適用于： Windows |Windows Server

JetStopBackup 函式

JetStopBackup函式可防止任何串流備份相關活動繼續在特定執行中的實例上，進而以可預測的方式結束串流備份。

Windowsxp： 此函式是在 Windows XP 中引進。

JetStopService 是只允許一個實例時的舊版呼叫。 在此情況下，唯一的作用中實例是準備終止的實例。

JET_ERR JET_API JetStopBackup(void);

參數

此函式沒有參數。

傳回值

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

傳回碼	Description
JET_errSuccess	作業已成功完成。
JET_errRunningInMultiInstanceMode	使用 JetStopService 搭配多個實例模式時，並不清楚要準備終止的實例。 Windowsxp： 這個傳回值是在 Windows XP 中引進。

如果此函式成功，實例將會開始失敗任何新的串流備份 API。

如果此函式失敗，將不會採取任何步驟來準備實例上的備份終止，而且不會變更實例狀態。

備註

備份通常是由進程機制外部的事件所觸發，而且使用此 API，ESENT 應用程式本身會對串流備份 API 進行任何進一步呼叫以失敗。 大部分的串流備份 API 都會開始失敗，JET_errBackupAbortByServer。 因此，任何串流備份進度 (JetReadFileInstance) 都會傳回錯誤。 仍然允許屬於備份終止 (的備份作業，例如 JetEndExternalBackupInstance) 。

規格需求

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

另請參閱

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService