Fungsi JetAttachDatabase2

Berlaku untuk: Windows | Windows Server

Fungsi JetAttachDatabase2

Fungsi JetAttachDatabase2 melampirkan file database untuk digunakan dengan instans database dan menentukan ukuran maksimum untuk database tersebut. Untuk menggunakan database, database harus kemudian dibuka dengan JetOpenDatabase.

    JET_ERR JET_API JetAttachDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          const unsigned long cpgDatabaseSizeMax,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

Konteks sesi database yang akan digunakan untuk panggilan API.

szFilename

Nama database yang akan dilampirkan.

cpgDatabaseSizeMax

Ukuran maksimum, di halaman database, untuk database. Ukuran halaman database default adalah 4 kilobyte, yang dapat diubah menggunakan fungsi JetSetSystemParameter sebelum membuat database.

Melewati nol berarti tidak ada maksimum yang diberlakukan oleh mesin database.

grbit

Sekelompok bit yang berisi opsi yang akan digunakan untuk panggilan ini, yang mencakup nol atau beberapa hal berikut:

Nilai	Makna
JET_bitDbDeleteCorruptIndexes	Jika JET_paramEnableIndexChecking telah diatur, semua indeks melalui data Unicode akan dihapus. Lihat bagian Keterangan untuk detail selengkapnya.
JET_bitDbDeleteUnicodeIndexes	Semua indeks melalui data Unicode akan dihapus, terlepas dari pengaturan JET_paramEnableIndexChecking. Lihat bagian Keterangan untuk detail selengkapnya.
JET_bitDbReadOnly	Mencegah modifikasi pada database.
JET_bitDbUpgrade	Disiapkan untuk penggunaan masa mendatang.

Tampilkan Nilai

Fungsi mengembalikan salah satu kode kesalahan JET_ERR . Berikut ini adalah yang paling umum dikembalikan. (Untuk daftar lengkap kesalahan untuk API ini, lihat Kode Kesalahan Mesin Penyimpanan yang Dapat Diperluas.)

Menampilkan kode	Deskripsi
JET_errSuccess	Operasi berhasil diselesaikan.
JET_errBackupInProgress	Melampirkan database tidak diperbolehkan selama pencadangan.
JET_errDatabaseFileReadOnly	File database yang ditentukan oleh szFilename harus dapat ditulis. Atribut Read-Only tidak boleh diatur, dan proses yang sedang berjalan harus memiliki hak istimewa yang memadai untuk menulis ke file.
JET_errDatabaseInUse	File database sudah dibuka oleh proses lain.
JET_errDatabaseInvalidPath	Jalur yang tidak valid diberikan dalam szFilename. szFilename harus non-NULL dan merujuk ke jalur yang valid.
JET_errDatabaseSharingViolation	File database telah dilampirkan oleh sesi lain.
JET_errFileNotFound	File yang diberikan dalam szFilename tidak ada.
JET_errPrimaryIndexCorrupted	Ada kesalahan dengan indeks utama. Ini mungkin dari kerusakan fisik (seperti disk atau kerusakan memori). Ini juga dapat dikembalikan saat melampirkan database yang terakhir diubah pada sistem operasi yang lebih lama dan indeks utama melebihi kolom dengan data Unicode. Lihat keterangan untuk informasi selengkapnya tentang indeks melalui data Unicode.
JET_errSecondaryIndexCorrupted	Ada kesalahan dengan indeks sekunder. Ini mungkin dari kerusakan fisik (seperti disk atau kerusakan memori). Ini juga dapat dikembalikan saat melampirkan database yang terakhir diubah pada sistem operasi yang lebih lama dan indeks sekunder melebihi kolom dengan data Unicode. Lihat keterangan untuk informasi selengkapnya tentang indeks melalui data Unicode. Indeks sekunder sepenuhnya dibangun kembali ketika database didefragmentasi dengan utilitas offline menggunakan perintah berikut: esentutl -d.
JET_errTooManyAttachedDatabases	Hanya jumlah database terbatas yang dapat dilampirkan per instans. Batasnya saat ini adalah tujuh database per instans.
JET_wrnDatabaseAttached	Peringatan nonfungsi yang menunjukkan bahwa file database telah dilampirkan oleh sesi ini.

Keterangan

File database dilepas menggunakan JetDetachDatabase atau JetDetachDatabase2.

Lihat JetAttachDatabase untuk keterangan.

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 JetAttachDatabase2W (Unicode) dan JetAttachDatabase2A (ANSI).

Lihat juga

File Mesin Penyimpanan yang Dapat Diperluas
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetCreateDatabase
JetOpenDatabase
JetSetSystemParameter