Fungsi JetGotoPosition

Berlaku untuk: Windows | Windows Server

Fungsi JetGotoPosition

Fungsi JetGotoPosition memindahkan kursor ke lokasi baru yang merupakan sebagian kecil dari jalan melalui indeks saat ini. Pecahannya kira-kira sama dengan yang berikut:

precpos-centriesLT>/precpos-centriesTotal>

Operasi ini dilakukan sebagai respons terhadap input kotak gulir pengguna yang diterima saat pengguna mencoba menampilkan data yang memulai sebagian melalui himpunan data.

    JET_ERR JET_API JetGotoPosition(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_RECPOS* precpos
    );

Parameter

sesid

Sesi yang digunakan untuk panggilan ini.

tableid

Kursor yang digunakan untuk panggilan ini.

prekpos

Deskripsi pecahan yang akan digunakan dalam memosisikan kursor dalam indeks saat ini.

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_errSuccess	Operasi berhasil diselesaikan.
JET_errClientRequestToStopJetService	Operasi tidak dapat diselesaikan karena semua aktivitas pada instans yang terkait dengan sesi telah berhenti 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_errInvalidParameter	Precpos-cbStruct> yang diberikan bukan ukuran yang valid untuk struktur JET_RECPOS , atau precpos-centriesLT> lebih besar dari precpos-centriesTotal>.
JET_errNotInitialized	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi belum diinisialisasi.
JET_errRecordNotFound	Kesalahan ini akan dikembalikan jika indeks kosong.
JET_errRestoreInProgress	Operasi tidak dapat diselesaikan karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.
JET_errSessionSharingViolation	Sesi yang sama tidak dapat digunakan untuk lebih dari satu utas secara bersamaan. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan.

Jika fungsi ini berhasil, kursor dipindahkan ke rekaman saat ini yang merupakan sebagian kecil dari cara melalui indeks di mana fraksi adalah precpos-centriesLT> dibagi dengan precpos-centriesTotal>.

Jika fungsi ini gagal, lokasi kursor dibiarkan tidak berubah.

Keterangan

Operasi ini memindahkan kursor melalui tabel ke posisi pada perkiraan titik berikut: precpos-centriesLT> dibagi dengan precpos-centriesTotal>.

Ketika pembaruan terjadi terus menerus pada tabel, panggilan berikutnya dengan JET_RECPOS yang sama dapat memindahkan kursor ke posisi yang berbeda dalam indeks, baik sebelum maupun sesudah posisi sebelumnya. Isolasi transaksional tidak berlaku untuk penempatan melalui JET_RECPOS karena tergantung pada properti fisik indeks yang tidak terisolasi transaksi.

JET_RECPOS tidak boleh digunakan untuk menjelaskan rekaman dalam tabel atau untuk memposisikan ulang rekaman yang dekat dengan rekaman yang sudah ada. Sebaliknya, marka buku untuk rekaman yang ada harus diambil setelah JetGotoPosition awal lalu digunakan untuk memposisikan ulang rekaman yang sama.

Persyaratan

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

Lihat juga

JET_COLUMNID
JET_ERR
JET_SESID
JET_TABLEID
JET_RECPOS
JET_SETINFO