Поделиться через

Функция 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

Список идентификаторов столбцов с длинными значениями для предварительного чтения. По умолчанию предварительно прочитывается только запись на странице. Если столбцы с длинными значениями вне страницы необходимо предварительно прочитать, их идентификаторы столбцов должны передаваться с помощью этого параметра.

ccolumnidPreread

Число идентификаторов столбцов с длинными значениями для предварительного чтения, определяемое количеством элементов в rgcolumnidPreread.

grbit

Группа битов, задающая ноль или больше значений предварительно прочитанного направления, перечисленных в следующей таблице.

Значение

Значение

Вперед

Предварительно прочитано вперед.

Назад

Предварительно прочитать назад.

FirstPageOnly

Предварительно прочитывает только первую страницу любого длинного столбца.

NormalizedKey

Вместо значения столбца указан нормализованный ключ или закладка.

Возвращаемое значение

Эта функция возвращает JET_ERR тип данных с одним из кодов возврата, перечисленных в следующей таблице. Дополнительные сведения о возможных ошибках подсистемы расширяемого хранилища (ESE) см. в разделах Ошибки расширяемого обработчика хранилища и Параметры обработки ошибок.

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

Комментарии

Если записи с указанными диапазонами ключей отсутствуют в буферном кэше, следует запустить асинхронные операции чтения, чтобы перенести записи в кэш буфера базы данных.

Требования

Требование Значение

Клиент

Требуется Windows 8.

Сервер

Требуется Windows Server 2012.

Верхняя часть

Объявлено в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

См. также раздел

JET_ERR