Fungsi JetPrereadIndexRanges

Berlaku untuk: Windows | Windows Server

Fungsi JetPrereadIndexRanges telah dibaca sebelumnya indeks untuk meningkatkan performa.

Fungsi JetPrereadIndexRanges diperkenalkan dalam sistem operasi 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
);

Parameter

sesid

Konteks sesi database yang akan digunakan untuk panggilan API.

tableid

Tabel untuk mengeluarkan prabayar terhadap.

rgIndexRanges

Rentang kunci untuk dibaca sebelumnya.

cIndexRanges

Jumlah rentang kunci yang akan dibaca sebelumnya, ditentukan oleh jumlah elemen dalam rgIndexRanges.

pcRangesPreread

Jumlah rentang kunci yang benar-benar telah dibaca sebelumnya.

rgcolumnidPreread

Daftar ID kolom untuk kolom nilai panjang yang akan dibaca sebelumnya. Secara default, hanya rekaman di halaman yang sudah dibaca sebelumnya. Jika kolom nilai panjang di luar halaman perlu dibaca sebelumnya, ID kolomnya perlu diteruskan melalui parameter ini.

ccolumnidPreread

Jumlah ID kolom untuk kolom nilai panjang yang akan dibaca sebelumnya, ditentukan oleh jumlah elemen dalam rgcolumnidPreread.

grbit

Sekelompok bit yang menentukan nol atau lebih dari nilai arah pra-dibaca yang tercantum dalam tabel berikut ini.

Nilai	Makna
Maju	Prabayar ke depan.
Mundur	Prabaca mundur.
FirstPageOnly	Baca hanya halaman pertama dari kolom panjang apa pun.
NormalizedKey	Kunci/bookmark yang dinormalisasi disediakan alih-alih nilai kolom.

Mengembalikan nilai

Fungsi ini mengembalikan jenis data JET_ERR dengan salah satu kode pengembalian yang tercantum dalam tabel berikut. Untuk informasi selengkapnya tentang kemungkinan kesalahan Extensible Storage Engine (ESE), lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas dan Parameter Penanganan Kesalahan.

Menampilkan kode	Deskripsi
JET_errSuccess	Operasi berhasil diselesaikan.

Keterangan

Jika rekaman dengan rentang kunci yang ditentukan tidak berada dalam cache buffer, Anda harus memulai pembacaan asinkron untuk membawa rekaman ke dalam cache buffer database.

Persyaratan

Persyaratan	Nilai
Klien	Membutuhkan Windows 8.
Server	Memerlukan Windows Server 2012.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.

Lihat juga

JET_ERR