Fungsi JetGetRecordSize2
Berlaku untuk: Windows | Windows Server
Fungsi JetGetRecordSize2
Fungsi JetGetRecordSize2 mengambil informasi ukuran rekaman dari lokasi yang diinginkan.
Windows 7: JetGetRecordSize2 diperkenalkan dalam sistem operasi Windows 7.
JET_ERR JET_API JetGetRecordSize2(
__in JET_SESID sesid,
__in JET_TABLEID tableid,
__out JET_RECSIZE2* precsize,
__in const JET_GRBIT grbit
);
Parameter
sesid
Mengidentifikasi konteks sesi database yang akan digunakan untuk panggilan API.
tableid
Mengidentifikasi tabel atau kursor yang akan digunakan untuk panggilan API. Kursor harus diposisikan pada rekaman, atau memiliki pembaruan yang disiapkan.
precsize
Penunjuk ke buffer output untuk struktur JET_RECSIZE2 .
grbit
Ini adalah satu atau beberapa nilai berikut.
Nilai |
Makna |
|---|---|
JET_bitRecordSizeInCopyBuffer |
Ini mengambil ukuran rekaman yang ada di penyangga salinan yang disiapkan untuk pembaruan. Jika tidak, tableid atau kursor harus diposisikan pada rekaman, dan rekaman tersebut akan digunakan. |
JET_bitRecordSizeRunningTotal |
Ketika bit ini ditentukan, JET_RECSIZE2 tidak di-nol sebelum mengisi konten, secara efektif bertindak sebagai akumulasi statistik untuk beberapa rekaman yang dikunjungi atau diperbarui. |
JET_bitRecordSizeLocal |
Ini menyebabkan API mengabaikan Nilai Panjang non-intrinsik. Misalnya, hanya rekaman lokal di halaman yang akan digunakan. |
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_errInvalidGrbit |
Salah satu opsi yang diminta tidak valid atau tidak diimplementasikan. Kesalahan ini akan dikembalikan oleh fungsi JetGetRecordSize2 ketika grbit ilegal ditentukan. |
JET_errNotInitialized |
Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi belum diinisialisasi. |
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. Windows XP: JET_errInstanceUnavailable hanya akan dikembalikan oleh sistem operasi Windows XP dan versi Windows yang lebih baru. |
JET_errTermInProgress |
Tidak dimungkinkan untuk menyelesaikan operasi karena instans yang terkait dengan sesi sedang dimatikan. |
JET_errRestoreInProgress |
Tidak dimungkinkan untuk menyelesaikan operasi karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi. |
JET_errSessionSharingViolation |
Adalah ilegal untuk menggunakan sesi yang sama untuk lebih dari satu utas secara bersamaan. Windows XP: JET_errInstanceUnavailable hanya akan dikembalikan oleh Windows XP dan versi Windows yang lebih baru. |
JET_errNoCurrentRecord |
Ini dapat terjadi jika kursor diposisikan dengan tidak benar. |
JET_errRecordDeleted |
Jika kursor tidak diposisikan dalam transaksi, ini dapat terjadi jika utas lain menghapus rekaman dari bawah sesi ini. |
JET_errInvalidParameter |
Ini dapat dikembalikan jika precsizeNULL diteruskan. |
Keterangan
Ukuran kunci yang terakumulasi di bidang cbOverheadJET_RECSIZE2, dipengaruhi oleh JET_bitRecordSizeInCopyBuffer. Jika bit ini ditentukan, ukuran kunci yang terakumulasi di bidang cbOverhead adalah ukuran kunci penuh. Jika bit ini tidak digunakan, ukuran kunci yang terakumulasi tidak akan menyertakan ukuran apa pun yang disimpan karena pemadatan awalan kunci.
Persyaratan
| Persyaratan | Nilai |
|---|---|
Klien |
Memerlukan Windows Vista. |
Server |
Memerlukan Windows Server 2008. |
Header |
Dinyatakan dalam Esent.h. |
Pustaka |
Gunakan ESENT.lib. |
DLL |
Membutuhkan ESENT.dll. |