通过

JetPrereadIndexRanges 函数

  • 项目

适用于： Windows |Windows Server

JetPrereadIndexRanges 函数预读索引以提高性能。

JetPrereadIndexRanges 函数是在Windows 8操作系统中引入的。

JET_ERR JetPrereadIndexRanges(
  __in          const JET_SESID sesid,
  __in          const JET_TABLEID tableid,
  __in_ecount(cIndexRanges)  const JET_INDEX_RANGE* const rgIndexRanges,
  __in          const unsigned long cIndexRanges,
  __out_opt     unsigned long* const pcRangesPreread,
  __in_ecount(ccolumnidPreread)  const JET_COLUMNID* const rgcolumnidPreread,
  __in          const unsigned long ccolumnidPreread,
  __in          const JET_GRBIT grbit
);

参数

sesid

用于 API 调用的数据库会话上下文。

tableid

要对其发出预读的表。

rgIndexRanges

要预读的键范围。

cIndexRanges

要预读的键范围数，由 rgIndexRanges 中的元素数决定。

pcRangesPreread

实际预读的键范围数。

rgcolumnidPreread

要预读的长值列的列 ID 列表。 默认情况下，仅预读页面记录。 如果需要预读“离页”长值列，则需要通过此参数传递其列 ID。

ccolumnidPreread

要预读的长值列的列 ID 数，由 rgcolumnidPreread 中的元素数确定。

grbit

一组位，指定下表中列出的零个或多个预读方向值。

值

含义

前进

向前预读。

向后

向后预读。

FirstPageOnly

仅预读任何长列的第一页。

NormalizedKey

提供的规范化键/书签，而不是列值。

返回值

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

返回代码

说明

JET_errSuccess

操作已成功完成。

备注

如果具有指定键范围的记录不在缓冲区缓存中，则应启动异步读取，以将记录引入数据库缓冲区缓存。

要求

要求 值

客户端

需要Windows 8。

服务器

需要Windows Server 2012。

标头

在 Esent.h 中声明。

Library

使用 ESENT.lib。

DLL

需要ESENT.dll。

另请参阅

JET_ERR