Fungsi JetGetRecordPosition
Berlaku untuk: Windows | Windows Server
Fungsi JetGetRecordPosition
Fungsi JetGetRecordPosition mengembalikan posisi pecahan rekaman saat ini dalam indeks saat ini dalam bentuk struktur JET_RECPOS . Struktur ini menjelaskan posisi pecahan dalam hal perkiraan jumlah entri indeks sebelum rekaman saat ini dan perkiraan jumlah total entri dalam indeks.
JET_ERR JET_API JetGetRecordPosition(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__out JET_RECPOS* precpos,
__in unsigned long cbRecpos
);
Parameter
sesid
Sesi yang digunakan untuk panggilan ini.
tableid
Kursor yang digunakan untuk panggilan ini.
precpos
Deskripsi pecahan yang akan digunakan dalam mendapatkan posisi rekaman saat ini dalam indeks saat ini.
cbRecpos
Ukuran memori yang dialokasikan di precpos.
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_errNotInitialized |
Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi belum diinisialisasi. |
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 ini tidak dapat diselesaikan karena instans, yang terkait dengan sesi, mengalami kesalahan fatal. Diperlukan akses ke semua data dicabut untuk melindungi integritas data tersebut. Windows 2000: Kesalahan ini tidak akan dikembalikan oleh sistem operasi Windows 2000. |
JET_errInvalidParameter |
Ukuran memori yang dialokasikan pada precpos bukan ukuran yang cukup. |
JET_errNoCurrentRecord |
Kursor saat ini tidak ada di rekaman dan tidak dapat mengembalikan posisi. |
JET_errRestoreInProgress |
Tidak dimungkinkan untuk menyelesaikan operasi 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 2000: Kesalahan ini tidak akan dikembalikan oleh sistem operasi Windows 2000. |
JET_errTermInProgress |
Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan. |
Jika berhasil, perkiraan jumlah entri indeks sebelum rekaman saat ini dalam indeks dikembalikan dalam precpos-centriesLT>. 1 dikembalikan dalam precpos-centriesInRange>. Perkiraan jumlah entri dalam indeks dikembalikan dalam precpos-centriesTotal>.
Jika gagal, tidak ada perubahan yang dilakukan pada memori yang dialokasikan sebelumnya.
Keterangan
Operasi ini mengembalikan data yang bervariasi ketika pembaruan terjadi terus menerus pada tabel. Perubahan nilai tidak akan selalu sesuai dengan harapan berdasarkan pengetahuan tentang pembaruan, karena nilainya adalah perkiraan berdasarkan properti fisik indeks. Isolasi transaksional tidak berlaku untuk posisi dari JetGetRecordPosition karena nilai bergantung pada properti fisik indeks yang tidak diisolasi transaksi.
JET_RECPOS tidak boleh digunakan untuk menjelaskan rekaman dalam tabel atau memposisikan ulang rekaman yang dekat dengan rekaman yang sudah ada. Sebagai gantinya, marka buku untuk rekaman yang ada harus diambil 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
JetGotoPosition
JetStopService