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