Fungsi JetDetachDatabase2

Berlaku untuk: Windows | Windows Server

Fungsi JetDetachDatabase2

Fungsi JetDetachDatabase2 merilis file database yang sebelumnya dilampirkan ke sesi database.

Windows XP:JetDetachDatabase2 diperkenalkan di Windows XP.

    JET_ERR JET_API JetDetachDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

Konteks sesi database yang akan digunakan untuk panggilan API.

szFilename

Nama database yang akan dicopot. Jika szFilenameadalah NULL atau string kosong, semua database yang dilampirkan ke sesid akan dilepaskan.

grbit

Sekelompok bit yang menentukan nol atau beberapa opsi berikut.

Nilai	Makna
JET_bitForceCloseAndDetach	Memaksa database ditutup dan dilepas. Jika JET_bitForceCloseAndDetach tidak didukung, JET_errForceDetachNotAllowed akan dikembalikan.
JET_bitForceDetach	Memaksa database untuk dilepaskan. Jika JET_bitForceDetach tidak didukung, JET_errForceDetachNotAllowed akan dikembalikan.

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_errBackupInProgress	Database sedang dicadangkan, dan tidak dapat dilepas.
JET_errDatabaseInUse	Database telah dibuka oleh JetOpenDatabase. Database harus ditutup sebelum mencopot.
JET_errDatabaseNotFound	Database sebelumnya tidak dilampirkan (Lihat JetAttachDatabase atau JetAttachDatabase2).
JET_errForceDetachNotAllowed	JET_bitForceDetach tidak didukung.
JET_errInTransaction	Upaya dilakukan untuk mencopot database saat bertransaksi.

Keterangan

Jika database terlampir dibuka (dengan JetAttachDatabase), database harus ditutup dengan JetCloseDatabase sebelum mencopot.

Hanya Windows 2000: Database yang belum dicopot sebelum memanggil JetTerm akan secara otomatis dilampirkan kembali ketika JetInit dipanggil berikutnya.

Persyaratan

Persyaratan	Nilai
Klien	Memerlukan Windows Vista atau Windows XP.
Server	Memerlukan Windows Server 2008 atau Windows Server 2003.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.
Unicode	Diimplementasikan sebagai JetDetachDatabase2W (Unicode) dan JetDetachDatabase2A (ANSI).

Lihat juga

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCloseDatabase
JetCreateDatabase
JetCreateDatabase2
JetInit
JetOpenDatabase
JetTerm