JetStopService 函数

适用于:Windows |Windows服务器

JetStopService 函数

JetStopService 函数准备用于终止的实例。

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

    JET_ERR JET_API JetStopService(void);

parameters

此函数没有参数。

返回值

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

返回代码

说明

JET_errSuccess

操作已成功完成。

JET_errRunningInMultiInstanceMode

目前还不清楚在将 JetStopService 与多个实例模式配合使用时要准备终止的实例。

Windows XP:Windows XP 中引入了此返回值。

如果此函数成功,它将为将来的终止做好准备。 为终止做准备的步骤包括:

  • 如果联机碎片整理正在运行,请停止联机碎片整理。

  • "开始"菜单版本存储清理。

  • 通过开始刷新缓冲区管理器中的脏页来减少检查点深度。

  • 防止将来对该实例的大多数函数进行调用。

如果此函数失败,则不会执行任何准备实例终止的步骤,因此不会更改实例状态。

注解

此函数可减少实例在终止时必须执行的操作,但不会终止实例。 因此,此函数只是优化,不是必需的。 请注意,在 2000 年Windows和 Windows XP 中完成的工作量更少。 函数成功后,调用不再允许的函数将返回JET_errClientRequestToStopJetService。 在此调用后仍允许的函数包括: JetRollbackJetCloseTableJetEndSessionJetCloseDatabaseJetDetachDatabaseJetResetSessionContext

要求

要求

客户端

需要 Windows Vista、Windows XP 或 Windows 2000 Professional。

Server

需要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