次の方法で共有

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

次の表に示す読み取り方向の値の 0 個以上を指定するビットのグループ。

値

説明

転送

前方に読み取る。

後ろへ

後方に読み取ります。

FirstPageOnly

長い列の最初のページのみを事前に読み取ります。

NormalizedKey

列値の代わりに指定された正規化されたキー/ブックマーク。

戻り値

この関数は、次の表に示すリターン コードの 1 つを使用して、 JET_ERR データ型を返します。 拡張可能記憶域エンジン (ESE) の可能性のあるエラーの詳細については、「 拡張記憶域エンジンエラー と エラー処理パラメーター」を参照してください。

リターン コード

説明

JET_errSuccess

操作は正常に完了しました。

注釈

指定したキー範囲のレコードがバッファー キャッシュにない場合は、非同期読み取りを開始して、レコードをデータベース バッファー キャッシュに取り込む必要があります。

要件

要件 値

Client

Windows 8が必要です。

[サーバー]

Windows Server 2012が必要です。

Header

Esent.h で宣言されています。

Library

ESENT.lib を使用します。

[DLL]

ESENT.dllが必要です。

こちらもご覧ください

JET_ERR