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
要預先讀取之完整值資料行的資料行識別碼清單。 根據預設，只會預先讀取頁面記錄。 如果需要預先讀取 Off-page long 值資料行，則必須透過此參數傳遞其資料行識別碼。
ccolumnidPreread
要預先讀取之長數值資料行的資料行識別碼數目，取決於 rgcolumnidPreread中的元素數目。
grbit
指定下表所列之零個或多個預先讀取方向值的位群組。
值 |
意義 |
|---|---|
轉寄 |
預先讀取。 |
向後 |
回溯預先讀取。 |
FirstPageOnly |
只預先讀取任何長資料行的第一頁。 |
NormalizedKey |
提供的標準化索引鍵/書簽，而不是資料行值。 |
傳回值
此函式會傳回具有下表所列其中一個傳回碼 的JET_ERR 資料類型。 如需可能的可延伸儲存引擎 (ESE) 錯誤的詳細資訊，請參閱 可延伸儲存引擎錯誤 和 錯誤處理參數。
傳回碼 |
描述 |
|---|---|
JET_errSuccess |
作業已成功完成。 |
備註
如果具有指定索引鍵範圍的記錄不在緩衝區快取中，您應該啟動非同步讀取，以將記錄帶入資料庫緩衝區快取。
規格需求
| 需求 | 值 |
|---|---|
用戶端 |
需要Windows 8。 |
Server |
需要Windows Server 2012。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |