Fungsi JetGotoSecondaryIndexBookmark
Berlaku untuk: Windows | Windows Server
Fungsi JetGotoSecondaryIndexBookmark
Fungsi JetGotoSecondaryIndexBookmark memposisikan kursor ke entri indeks yang terkait dengan bookmark indeks sekunder yang ditentukan. Bookmark indeks sekunder harus digunakan dengan indeks yang sama di atas tabel yang sama tempat awalnya diambil. Bookmark indeks sekunder untuk entri indeks dapat diambil menggunakan JetGotoSecondaryIndexBookmark.
Windows XP:JetGotoSecondaryIndexBookmark diperkenalkan di Windows XP.
JET_ERR JET_API JetGotoSecondaryIndexBookmark(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__in void* pvSecondaryKey,
__in unsigned long cbSecondaryKey,
__in_opt void* pvPrimaryBookmark,
__in unsigned long cbPrimaryBookmark,
__in const JET_GRBIT grbit
);
Parameter
sesid
Sesi yang digunakan untuk panggilan ini.
tableid
Kursor yang digunakan untuk panggilan ini.
pvSecondaryKey
Buffer yang berisi kunci sekunder untuk digunakan untuk memosisikan kursor.
cbSecondaryKey
Ukuran kunci sekunder dalam buffer.
pvPrimaryBookmark
Buffer yang berisi marka buku kunci utama untuk digunakan untuk memosisikan kursor.
cbPrimaryBookmark
Ukuran bookmark kunci utama di buffer.
grbit
Sekelompok bit yang menentukan nol atau beberapa opsi berikut.
Nilai |
Makna |
---|---|
JET_bitBookmarkPermitVirtualCurrency |
Jika entri indeks tidak dapat ditemukan lagi, kursor akan dibiarkan diposisikan di mana entri indeks tersebut sebelumnya ditemukan. Operasi masih akan gagal dengan JET_errRecordDeleted; namun, dimungkinkan untuk pindah ke entri indeks berikutnya atau sebelumnya relatif terhadap entri indeks yang sekarang hilang. |
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 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_errInvalidBookmark |
Marka buku indeks sekunder yang disediakan tidak valid. Kesalahan ini mungkin terjadi karena kunci sekunder adalah nol atau penunjuk buffer kunci sekunder adalah NULL. Kesalahan ini terjadi karena
|
JET_errNoCurrentIndex |
Kursor saat ini tidak berada pada indeks sekunder. Tidak bermakna untuk membuka bookmark indeks sekunder ketika kursor saat ini tidak menggunakan indeks sekunder. JetGotoBookmark harus digunakan ketika kursor tidak berada pada indeks sekunder. |
JET_errNotInitialized |
Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi belum diinisialisasi. |
JET_errRecordDeleted |
Entri indeks yang terkait dengan bookmark indeks sekunder tidak dapat ditemukan. |
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 akan diposisikan pada entri indeks yang terkait dengan marka buku indeks sekunder yang ditentukan. Jika rekaman telah disiapkan untuk pembaruan, pembaruan tersebut akan dibatalkan. Jika rentang indeks berlaku, rentang indeks tersebut akan dibatalkan. Jika kunci pencarian telah dibuat agar kursor dapat digunakan, kunci pencarian tersebut akan dihapus. Tidak ada perubahan pada status database yang akan terjadi.
Jika fungsi ini gagal, posisi kursor tetap tidak berubah kecuali JET_errRecordDeleted dikembalikan dan JET_bitBookmarkPermitVirtualCurrency ditentukan. Dalam hal ini, kursor akan diposisikan di mana entri indeks yang terkait dengan marka buku indeks sekunder yang ditentukan akan berada. Kursor dapat dipindahkan relatif terhadap posisi tersebut, tetapi masih tidak pada entri indeks yang valid.
Jika rekaman telah disiapkan untuk pembaruan, pembaruan tersebut akan dibatalkan. Jika rentang indeks berlaku, rentang indeks tersebut akan dibatalkan. Jika kunci pencarian telah dibuat agar kursor dapat digunakan, kunci pencarian tersebut akan dihapus. Bagaimanapun, tidak ada perubahan pada status database yang akan terjadi.
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
JetGetSecondaryIndexBookmark
JetGotoBookmark
JetStopService