Fungsi JetOpenDatabase

Berlaku untuk: Windows | Windows Server

Fungsi JetOpenDatabase

Fungsi JetOpenDatabase membuka database yang dilampirkan sebelumnya, menggunakan fungsi JetAttachDatabase atau JetAttachDatabase2 , untuk digunakan dengan sesi database. Fungsi ini dapat dipanggil beberapa kali untuk database yang sama.

    JET_ERR JET_API JetOpenDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in_opt      const tchar* szConnect,
      __out         JET_DBID* pdbid,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

Konteks sesi database yang digunakan untuk panggilan API.

szFilename

Nama database yang akan dibuka.

szConnect

Dicadangkan. Atur ke NULL.

pdbid

Penunjuk ke buffer yang, pada panggilan berhasil, berisi pengidentifikasi database. Jika panggilan gagal, nilainya tidak terdefinisi.

grbit

Sekelompok bit yang menentukan nol atau beberapa opsi berikut.

Nilai	Makna
JET_bitDbExclusive	Hanya mengizinkan satu sesi untuk melampirkan database. Biasanya, beberapa sesi dapat membuka database.
JET_bitDbReadOnly	Mencegah modifikasi pada database.

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_errDatabaseInUse	Akses eksklusif diminta, tetapi tidak dapat diberikan.
JET_errDatabaseInvalidPath	Jalur yang tidak valid diberikan dalam szFilename. szFilename harus non-NULL dan merujuk ke file yang valid.
JET_errDatabaseLocked	Sesi lain telah membuka database secara eksklusif (menggunakan JET_bitDbExclusive).
JET_errDatabaseNotFound	Database sebelumnya tidak dilampirkan (Lihat JetAttachDatabase).
JET_errInvalidDatabase	Upaya dilakukan untuk membuka file yang bukan file database yang valid.
JET_errOneDatabasePerSession	Upaya dilakukan untuk membuka lebih dari satu database, dan JET_paramOneDatabasePerSession ditetapkan. Untuk informasi selengkapnya, lihat Parameter Sistem.
JET_wrnFileOpenReadOnly	File dilampirkan sebagai baca-saja, tetapi JetOpenDatabase tidak lulus JET_bitDbReadOnly. Database masih dibuka dengan akses baca-saja.

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 JetOpenDatabaseW (Unicode) dan JetOpenDatabaseA (ANSI).

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
Parameter Sistem