Fungsi JetSetTableSequential

Berlaku untuk: Windows | Windows Server

Fungsi JetSetTableSequential

Fungsi JetSetTableSequential memberi tahu mesin database bahwa aplikasi memindai seluruh indeks saat ini yang berisi kursor tertentu. Akibatnya, metode yang digunakan untuk mengakses data indeks akan disetel untuk membuat skenario ini secepat mungkin.

Windows XP:JetSetTableSequential diperkenalkan di Windows XP.

    JET_ERR JET_API JetSetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

Sesi yang digunakan untuk panggilan ini.

tableid

Kursor yang digunakan untuk panggilan ini.

grbit

Sekelompok bit yang menentukan nol atau beberapa opsi berikut.

Nilai	Makna
JET_bitPrereadForward	Opsi ini digunakan untuk mengindeks ke arah maju. Windows 7:JET_bitPrereadForward diperkenalkan di Windows 7.
JET_bitPrereadBackward	Opsi ini digunakan untuk mengindeks ke arah mundur. Windows 7:JET_bitPrereadBackward diperkenalkan di Windows 7.

Tampilkan Nilai

Fungsi ini mengembalikan jenis data JET_ERR dengan salah satu kode pengembalian berikut. Untuk informasi selengkapnya tentang kemungkinan kesalahan ESE, lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas dan Parameter Penanganan Kesalahan.

Menampilkan kode	Deskripsi
JET_errClientRequestToStopJetService	Operasi tidak dapat diselesaikan karena semua aktivitas pada instans yang terkait dengan sesi telah didiamkan sebagai akibat dari panggilan ke JetStopService.
JET_errInstanceUnavailable	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi mengalami kesalahan fatal yang mengharuskan akses ke semua data dicabut untuk melindungi integritas data tersebut. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP.
JET_errNotInitialized	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi belum diinisialisasi.
JET_errRestoreInProgress	Operasi tidak dapat diselesaikan karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan.

Jika fungsi ini berhasil, indeks kursor saat ini dioptimalkan untuk pemindaian berurutan dari seluruh indeks. Tidak ada perubahan pada status database yang akan terjadi.

Jika fungsi ini gagal, tidak ada perubahan pada konfigurasi kursor yang akan terjadi. Tidak ada perubahan pada status database yang akan terjadi.

Keterangan

Jika aplikasi perlu memindai subset indeks yang diketahui secara efisien, pengoptimalan serupa juga dilakukan setiap kali rentang indeks dibuat dengan menggunakan JetSetIndexRange. Pengoptimalan ini hanya tersedia pada Windows XP dan rilis yang lebih baru.

Jika aplikasi perlu memindai subset indeks yang tidak diketahui secara efisien, tidak ada tindakan yang harus diambil. Mesin dapat secara otomatis mendeteksi perilaku pemindaian dan akan mengambil data sebelumnya. Namun, perilaku ini tidak agresif.

Pengoptimalan ini akan membuat pemindaian indeks utama efisien dan akan membuat pemindaian hanya data entri indeks dalam indeks sekunder menjadi efisien. Ini tidak akan membuat pemindaian indeks sekunder sambil mengambil data rekaman yang efisien. Ini karena mesin tidak melakukan read-ahead pada data rekaman.

Persyaratan

Persyaratan	Nilai
Klien	Memerlukan Windows Vista atau Windows XP.
Server	Memerlukan Windows Server 2008 atau Windows Server 2003.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetIndexRange
JetStopService