JetStopService 函数

适用于： Windows |Windows Server

JetStopService 函数

JetStopService 函数为终止准备实例。

JetStopService 是仅允许一个实例时的旧调用。 在这种情况下，唯一的活动实例是准备终止的实例。

    JET_ERR JET_API JetStopService(void);

parameters

此函数没有参数。

返回值

此函数返回具有以下返回代码之一 的JET_ERR 数据类型。 有关可能的 ESE 错误的详细信息，请参阅 可扩展存储引擎错误 和 错误处理参数。

返回代码	描述
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。
服务器	需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。
标头	在 Esent.h 中声明。
Library	使用 ESENT.lib。
DLL	需要ESENT.dll。

另请参阅

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2