Fungsi JetGetRecordSize

Berlaku untuk: Windows | Windows Server

Fungsi JetGetRecordSize

Fungsi JetGetRecordSize mengambil informasi ukuran rekaman dari lokasi yang diinginkan.

Windows Vista: JetGetRecordSize diperkenalkan di Windows Vista.

    JET_ERR JET_API JetGetRecordSize(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __out         JET_RECSIZE* 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_RECSIZE .

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_RECSIZE 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 JetGetRecordSize 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 Windows XP dan rilis 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 dari lebih dari satu utas secara bersamaan. Windows XP: JET_errInstanceUnavailable hanya akan dikembalikan oleh Windows XP dan rilis 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_RECSIZE, dipengaruhi oleh JET_bitRecordSizeInCopyBuffer. Jika bit ini ditentukan, ukuran kunci yang terakumulasi di bidang cbOverhead adalah ukuran kunci penuh. Jika bit ini tidak digunakan, maka 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.

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_RECSIZE
JET_TABLEID