JetStopServiceInstance 函式

適用于： Windows |Windows Server

JetStopServiceInstance 函式

JetStopServiceInstance函式會準備實例以進行終止。

Windows XP：JetStopServiceInstance 是在 Windows XP 中引進。

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

參數

instance

要用於 API 呼叫的執行實例。

傳回值

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

傳回碼	Description
JET_errSuccess	作業已成功完成。
JET_errInvalidParameter	指定的實例參數具有不正確值， (不是目前正在執行) 的實例。 Windowsxp： 此傳回值會在 Windows XP 中引進。

如果此函式成功，它會準備未來終止。 準備終止的步驟包括：

• 如果正在執行，請停止線上重組。

• 啟動版本存放區清除。

• 藉由開始排清緩衝區管理員中的已變更頁面，以減少檢查點深度。

• 防止未來呼叫該實例的大部分函式。

如果此函式失敗，則不會採取任何準備實例終止的步驟，因此不會變更實例狀態。

備註

此函式會減少實例在終止但不會終止實例時必須執行的工作。 因此，此函式只是優化，並非必要使用。 請注意，在準備期間完成的工作量在 Windows 2000 和 Windows XP 中較少。 函式成功之後，呼叫不再允許的函式將會傳回JET_errClientRequestToStopJetService。 此呼叫之後仍允許的函式包括： JetRollback、 JetCloseTable、 JetEndSession、 JetCloseDatabase、 JetDetachDatabase 和 JetResetSessionCoNtext。

規格需求

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

另請參閱

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionCoNtext
JetRollback
JetTerm
JetTerm2