JetIdle 函数

适用于: Windows |Windows Server

JetIdle 函数

JetIdle 函数已失效,应仅用于测试目的。 JetIdle 可用于执行空闲清理任务或检查 ESE 中的版本存储状态。

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

参数

sesid

将用于此调用的会话。

grbit

一组位,其中包含要用于此调用的选项,其中包括以下零个或多个位:

含义

JET_bitIdleCompact

触发版本存储的清理。

JET_bitIdleFlushBuffers

保留供将来使用。 如果指定此标志,API 将返回JET_errInvalidgrbit。

JET_bitIdleStatus

如果版本存储超过一半已满,则返回JET_wrnIdleFull。

返回值

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

返回代码

说明

JET_errSuccess

操作已成功完成。

JET_errInvalidParameter

提供给 API 的 grbit 参数无效。

如果此函数成功,将触发相应的操作,或指示版本存储的满满程度(具体取决于提供的 grbit )的错误代码。

如果此函数失败,则请求的操作不会成功完成。

备注

版本存储维护 ESE 的快照隔离机制。 如果版本存储区已满一半以上,则程序可能会关闭长时间运行的事务。 如果长时间运行的事务耗尽了版本存储,ESE 将停止允许对数据库执行写入操作。

要求

要求

客户端

需要 Windows Vista、Windows XP 或 Windows 2000 专业版。

服务器

需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。

标头

在 Esent.h 中声明。

Library

使用 ESENT.lib。

DLL

需要ESENT.dll。

另请参阅

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction