Fungsi JetResizeDatabase

Artikel
06/13/2023

Berlaku untuk: Windows | Windows Server

Fungsi JetResizeDatabase memperluas atau menyusutkan ukuran database yang saat ini terbuka.

Fungsi JetResizeDatabase diperkenalkan dalam sistem operasi Windows 8.

JET_ERR JET_API JetResizeDatabase(
  __in          JET_SESID sesid,
  __in          JET_DBID dbid,
  __in          unsigned long cpg,
  __out         unsigned long* pcpgActual,
  __in          const JET_GRBIT grbit
);

Parameter

sesid

Konteks sesi database yang akan digunakan untuk panggilan API.

dbid

Database yang akan diperluas.

Cpg

Ukuran database yang diminta, di halaman.

pcpgActual

Penunjuk ke nomor yang menerima ukuran database, di halaman, setelah panggilan API. Jika panggilan API gagal, konten parameter pcpgActual tidak terdefinisi.

grbit

Sekelompok bit yang menentukan nol atau beberapa nilai yang tercantum dalam tabel berikut ini.

Nilai	Makna
JET_bitResizeDatabaseOnlyGrow	Hanya menumbuhkan database. Jika panggilan mengubah ukuran akan menyusutkan database, jangan lakukan apa pun.

Nilai kembali

Fungsi ini mengembalikan jenis data JET_ERR dengan salah satu kode pengembalian yang tercantum dalam tabel berikut. Untuk informasi selengkapnya tentang kemungkinan kesalahan Extensible Storage Engine (ESE), lihat Kesalahan Mesin Penyimpanan yang Dapat Diperluas dan Parameter Penanganan Kesalahan.

Menampilkan kode	Deskripsi
JET_errSuccess	Operasi berhasil diselesaikan.
JET_errDiskFull	Tidak ada cukup ruang kosong pada volume untuk melakukan operasi yang tumbuh.
JET_errcakramIO	Kesalahan terkait file dikembalikan oleh fungsi JetSetDatabaseSize . Untuk informasi selengkapnya tentang kesalahan terkait file lain yang mungkin dikembalikan, lihat JetSetDatabaseSize.

Keterangan

Jika fungsi JetResizeDatabase dipanggil sebelum menyisipkan data dalam jumlah besar, file database akan ditanam dalam satu operasi. Ini akan mengurangi kemungkinan file database menjadi terfragmentasi pada tingkat sistem file, dan juga mengurangi berapa kali file database harus ditumbuhkan. Menumbuhkan file database sekali bisa lebih cepat daripada mengembangkannya beberapa kali.

Untuk mengatur ukuran database yang tidak dibuka, lihat JetSetDatabaseSize.

Ukuran file mungkin tidak cocok dengan jumlah halaman yang dikembalikan dalam parameter pcpgReal . Dua halaman cadangan tambahan mungkin tidak dihitung dalam parameter pcpgReal .

Persyaratan

Persyaratan	Nilai
Klien	Membutuhkan Windows 8.
Server	Memerlukan Windows Server 2012.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize

Bagikan melalui