JetStopService 函式
適用于: Windows |Windows Server
JetStopService 函式
JetStopService函式會準備終止的實例。
JetStopService 是只允許一個實例時的舊版呼叫。 在此情況下,唯一的作用中實例是準備終止的實例。
JET_ERR JET_API JetStopService(void);
參數
此函式沒有參數。
傳回值
此函式會傳回具有下列其中一個傳回碼 的 JET_ERR 資料類型。 如需可能 ESE 錯誤的詳細資訊,請參閱 可延伸儲存引擎錯誤 和 錯誤處理參數。
傳回碼 |
Description |
---|---|
JET_errSuccess |
作業已成功完成。 |
JET_errRunningInMultiInstanceMode |
使用 JetStopService 搭配多個實例模式時,並不清楚要準備終止的實例。 Windowsxp: 這個傳回值是在 Windows XP 中引進。 |
如果此函式成功,它會準備未來終止。 準備終止的步驟包括:
如果正在執行,請停止線上重組。
啟動版本存放區清除。
開始排清緩衝區管理員中的中途分頁,以減少檢查點深度。
防止未來呼叫該實例的大部分函式。
如果此函式失敗,將不會採取任何步驟來準備實例終止,因此不會變更實例狀態。
備註
此函式會減少實例在終止時必須執行的工作,但不會終止實例。 因此,此函式只是優化,並非必要使用。 請注意,在 Windows 2000 和 Windows XP 中,準備中完成的工作量較少。 函式成功之後,呼叫不再允許的函式將會傳回JET_errClientRequestToStopJetService。 此呼叫之後仍允許的函式為: JetRollback、 JetCloseTable、 JetEndSession、 JetCloseDatabase、 JetDetachDatabase 和 JetResetSessionCoNtext。
規格需求
需求 | 值 |
---|---|
用戶端 |
需要 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_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionCoNtext
JetRollback
JetTerm
JetTerm2