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

指定下表所列之零個或多個預先讀取方向值的位群組。

傳回值

此函式會傳回具有下表所列其中一個傳回碼 的JET_ERR 資料類型。 如需可能的可延伸儲存引擎 (ESE) 錯誤的詳細資訊，請參閱 可延伸儲存引擎錯誤 和 錯誤處理參數。

備註

如果具有指定索引鍵範圍的記錄不在緩衝區快取中，您應該啟動非同步讀取，以將記錄帶入資料庫緩衝區快取。

規格需求

另請參閱

JET_ERR