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