Fungsi JetGrowDatabase

Berlaku untuk: Windows | Windows Server

Fungsi JetGrowDatabase

Fungsi JetGrowDatabase memperluas ukuran database yang saat ini terbuka.

    JET_ERR JET_API JetGrowDatabase(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          unsigned long cpg,
      __in          unsigned long* pcpgReal
    );

Parameter

sesid

Konteks sesi database yang digunakan untuk panggilan API.

dbid

Database yang akan diperluas.

Cpg

Ukuran database yang diinginkan, di halaman.

pcpgReal

Arahkan ke nomor yang menerima ukuran database, di halaman, setelah panggilan API. Jika panggilan API gagal, konten pcpgReal tidak terdefinisi.

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_errDiskFull	Tidak ada cukup ruang kosong pada volume untuk melakukan operasi yang tumbuh.
JET_errcakramIO	Kesalahan terkait file dikembalikan oleh JetSetDatabaseSize. Untuk informasi selengkapnya tentang kesalahan terkait file lain yang mungkin dikembalikan, lihat JetSetDatabaseSize.

Keterangan

Jika JetGrowDatabase dipanggil sebelum memasukkan data dalam jumlah besar, file database akan ditumbuhkan 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.

Hanya menumbuhkan file yang saat ini didukung. Untuk menyusutkan file, gunakan fitur defragmentasi program utilitas esentutl.exe .

Untuk mengatur ukuran database yang tidak dibuka, lihat JetSetDatabaseSize.

Ukuran file mungkin tidak cocok dengan jumlah halaman yang dikembalikan di pcpgReal. Ada dua halaman cadangan tambahan yang mungkin tidak dihitung dalam pcpgReal.

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_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetSetDatabaseSize