Fungsi JetGetCursorInfo

Berlaku untuk: Windows | Windows Server

Fungsi JetGetCursorInfo

Fungsi JetGetCursorInfo digunakan untuk menentukan apakah pembaruan rekaman kursor saat ini akan mengakibatkan konflik tulis, berdasarkan status pembaruan rekaman saat ini. Ada kemungkinan bahwa konflik tulis pada akhirnya akan dikembalikan bahkan jika JetGetCursorInfo mengembalikan JET_errSuccess, karena sesi lain dapat memperbarui rekaman sebelum sesi saat ini dapat memperbarui rekaman yang sama.

    JET_ERR JET_API JetGetCursorInfo(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

Parameter

sesid

Sesi yang akan digunakan untuk panggilan ini.

tableid

Kursor yang akan digunakan untuk panggilan ini.

pvResult

Disiapkan untuk penggunaan masa mendatang.

cbMax

Harus diatur ke 0 (nol), jika tidak tidak digunakan. Ini hadir untuk fungsionalitas di masa depan.

InfoLevel

Harus diatur ke 0 (nol), jika tidak tidak digunakan. Ini hadir untuk fungsionalitas di masa depan.

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	Tidak dimungkinkan untuk menyelesaikan operasi karena semua aktivitas pada instans yang terkait dengan sesi telah berhenti sebagai akibat dari panggilan ke JetStopService.
JET_errInstanceUnavailable	Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi telah mengalami kesalahan fatal yang mengharuskan akses ke semua data dicabut untuk melindungi integritas data tersebut. Kesalahan ini hanya akan dikembalikan oleh Windows XP dan rilis yang lebih baru.
JET_errInvalidParameter	CbMax bukan 0 (nol) atau InfoLevel bukan 0 (nol).
JET_errNoCurrentRecord	Kursor saat ini tidak ada di rekaman dan informasi pada rekaman logika tidak dapat dikembalikan sebagai hasilnya.
JET_errNotInitialized	Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi belum diinisialisasi.
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. Kesalahan ini hanya akan dikembalikan oleh Windows XP dan rilis yang lebih baru.
JET_errTermInProgress	Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi sedang dimatikan.
JET_errWriteConflict	Catatan kursor saat ini telah diperbarui oleh sesi lain dan pembaruan rekaman ini oleh sesi ini akan mengakibatkan konflik tulis.

Jika berhasil, operasi ini tidak berpengaruh pada lokasi kursor tetapi hanya menunjukkan bahwa tidak ada sesi lain yang saat ini memperbarui rekaman ini.

Jika gagal, jika kode kesalahan negatif dikembalikan, tidak ada efek pada kursor atau database.

Keterangan

Operasi ini tidak memengaruhi status kursor atau data. Ini hanya mengembalikan kode kesalahan yang menjelaskan apakah pembaruan ke rekaman saat ini oleh sesi panggilan diketahui menghasilkan JET_errWriteConflict, atau tidak diketahui untuk mengembalikan JET_errWriteConflict. Jika sesi lain telah memperbarui rekaman ini untuk menggunakannya, dipastikan bahwa pembaruan rekaman ini oleh sesi ini akan mengakibatkan konflik tulis. Ini akan berlaku sampai sesi ini melakukan atau mengembalikan transaksinya ke tingkat transaksi 0 (nol). Namun, jika JetGetCursorInfo mengembalikan JET_errSuccess, sesi lain masih dapat memperbarui rekaman ini sebelum sesi saat ini dan dengan demikian masih mungkin bahwa pembaruan rekaman saat ini oleh sesi ini dalam transaksinya saat ini akan mengakibatkan konflik tulis.

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_ERR
JET_SESID
JET_TABLEID
JetGetLock
JetPrepareUpdate
JetStopService
JetUpdate