Fungsi JetSetDatabaseSize

Berlaku untuk: Windows | Windows Server

Fungsi JetSetDatabaseSize

Fungsi JetSetDatabaseSize mengatur ukuran file database yang tidak dibuka.

    JET_ERR JET_API JetSetDatabaseSize(
      __in          JET_SESID sesid,
      __in          JET_PCSTR szDatabaseName,
      __in          unsigned long cpg,
      __out         unsigned long* pcpgReal
    );

Parameter

sesid

Mengidentifikasi konteks sesi database yang akan digunakan untuk panggilan API.

szDatabaseName

Mengidentifikasi nama file database yang ukurannya akan diubah.

Cpg

Menentukan ukuran database yang diinginkan, di halaman.

pcpgReal

Arahkan ke nomor yang menerima ukuran database, di halaman, setelah panggilan API. Jika panggilan API tidak berhasil, 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_errDatabaseInconsistent
JET_errDatabaseDirtyShutdown

JET_errDatabaseInconsistent dan JET_errDatabaseDirtyShutdown adalah nilai numerik yang sama. Database yang ukurannya akan disesuaikan harus dalam pematian yang bersih, yang dikenal sebagai status konsisten. Database yang tidak konsisten tidak rusak, tetapi mengharuskan file log diputar ulang.

JET_errDatabaseInvalidPath

szDatabaseName tidak boleh berupa string kosong dan bukan NULL.

JET_errDiskFull

Tidak ada cukup ruang kosong pada volume untuk melakukan operasi yang tumbuh. JetSetDatabaseSize juga dapat mengembalikan banyak kesalahan terkait file, termasuk, tetapi tidak terbatas pada:

  • JET_errcakramIO

  • JET_errFileNotFound

  • JET_errInvalidPath

  • JET_errFileAccessDenied

  • JET_errOutOfFileHandles

JET_errInvalidParameter

Salah satu alasan kesalahan ini dapat dikembalikan adalah jika cpg memang memenuhi ukuran database minimum. Ukuran database minimum saat ini adalah 256 halaman.

JET_errOutOfMemory

Sistem hampir kehabisan sumber daya memori.

Keterangan

Jika JetSetDatabaseSize 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.

Jika cpg lebih kecil dari ukuran database saat ini, operasi akan diabaikan. Jika cpg kurang dari ukuran database minimum (saat ini 256 halaman), cpg akan mengembalikan JET_errInvalidParameter.

Untuk mengatur ukuran database yang dibuka, lihat JetGrowDatabase.

Ukuran file mungkin tidak cocok dengan jumlah halaman yang dikembalikan dalam 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.

Unicode

Diimplementasikan sebagai JetSetDatabaseSizeW (Unicode) dan JetSetDatabaseSizeA (ANSI).

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
JetGrowDatabase

  • Last updated on