适用于: 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。 |