Fungsi JetTerm2

Berlaku untuk: Windows | Windows Server

Fungsi JetTerm2

Fungsi JetTerm2 memulai pematian instans yang telah diinisialisasi oleh JetInit.

JetTerm2 juga dapat menghancurkan instans yang tidak diinisialisasi yang dibuat oleh JetCreateInstance.

    JET_ERR JET_API JetTerm2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Parameter

Sebagai contoh

Instans yang digunakan untuk panggilan ini.

Windows 2000: Parameter ini diabaikan dan harus selalu NULL.

Windows XP dan rilis yang lebih baru: Parameter ini kelebihan beban. Jika mesin beroperasi dalam mode warisan (mode kompatibilitas Windows 2000) di mana hanya satu instans yang didukung, maka parameter ini mungkin NULL atau mungkin berisi instans aktual yang dikembalikan oleh JetInit. Jika mesin beroperasi dalam mode multi-instans, maka parameter ini harus menjadi penunjuk ke instans yang dibuat menggunakan JetCreateInstance.

grbit

Sekelompok bit yang berisi opsi yang akan digunakan untuk panggilan ini, yang menyertakan nol atau beberapa nilai berikut.

Nilai	Makna
JET_bitTermComplete	Meminta agar instans dimatikan dengan bersih. Setiap pekerjaan pembersihan opsional yang biasanya akan dilakukan di latar belakang pada durasi segera selesai.
JET_bitTermAbrupt	Meminta agar instans dimatikan secepat mungkin. Setiap pekerjaan opsional yang biasanya akan dilakukan di latar belakang pada durasi ditinggalkan. Catatan Opsi ini dapat menyebabkan kehilangan ruang sementara atau permanen dalam database. Ruang yang hilang ini selalu dapat dipulihkan melalui defragmentasi offline database.
JET_bitTermStopBackup	Meminta agar instans dimatikan bahkan jika saat ini ada pencadangan yang sedang berlangsung. Biasanya, pencadangan yang tertunda akan menyebabkan JetTerm gagal dengan JET_errBackupInProgress. Ketika parameter ini tidak ada, nilainya dianggap JET_bitTermAbrupt.
JET_bitTermDirty	Meminta agar instans dimatikan dengan semua database terlampir yang tersisa dalam keadaan kotor. Windows 7: JET_bitTermDirty diperkenalkan di Windows 7.

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	Operasi tidak dapat diselesaikan karena operasi pencadangan sedang berlangsung pada instans.
JET_errInvalidParameter	Salah satu parameter yang disediakan berisi nilai yang tidak terduga, atau kombinasi beberapa parameter menghasilkan hasil yang tidak terduga. Kesalahan ini akan dikembalikan oleh JetTerm ketika mesin berada dalam mode multi-instans dan ketika pinstance mengacu pada instans yang tidak valid. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP.
JET_errNotInitialized	Operasi tidak dapat diselesaikan karena instans belum diinisialisasi.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans sedang dimatikan.
JET_errRestoreInProgress	Tidak dimungkinkan untuk menyelesaikan operasi karena operasi pemulihan sedang berlangsung pada instans.
JET_errTooManyActiveUsers	Instans tidak dapat dimatikan karena saat ini ada sesi dengan transaksi aktif untuk instans yang ditentukan. Kesalahan ini terjadi hanya jika JET_bitTermComplete digunakan.

Jika fungsi ini berhasil, instans yang ditentukan akan dimatikan. Handel instans juga akan ditutup dan dibuat tidak tersedia untuk API apa pun yang mengambil handel instans. Semua objek lain yang terkait dengan instans, seperti sesi, juga akan ditutup. Status file titik pemeriksaan, file log transaksi, dan file database yang dilampirkan ke instans akan dimodifikasi selama proses matikan.

Jika fungsi ini gagal sebagai akibat dari kesalahan penggunaan, maka instans tetap dalam status diinisialisasi dan tidak ada yang berubah. Jika tidak, instans masih dimatikan seperti yang dinyatakan untuk kasus keberhasilan. Perbedaannya adalah bahwa instans harus melalui pemulihan crash ketika diinisialisasi berikutnya. Mesin akan mencoba membersihkan data sebanyak mungkin untuk meminimalkan jumlah pemulihan yang diperlukan. Secara konseptual, kegagalan JetTerm seperti itu tidak berbeda dari crash proses.

Keterangan

Lihat JetTerm.

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

File Mesin Penyimpanan yang Dapat Diperluas
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm