Fungsi JetTerm

Berlaku untuk: Windows | Windows Server

Fungsi JetTerm

Fungsi JetTerm memulai pematian instans yang telah diinisialisasi oleh JetInit.

JetTerm juga dapat digunakan untuk menghancurkan instans yang tidak diinisialisasi yang dibuat oleh JetCreateInstance.

    JET_ERR JET_API JetTerm(
      __in          JET_INSTANCE instance
    );

Parameter

Sebagai contoh

Menentukan instans yang akan 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.

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_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_errBackupInProgress	Operasi tidak dapat diselesaikan karena operasi pencadangan 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 keadaan diinisialisasi dan tidak ada yang berubah. Jika tidak, instans masih dimatikan sesuai 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

Jika proses host instans berhenti karena alasan apa pun sebelum JetTerm berhasil dipanggil pada instans tersebut, instans dianggap dalam keadaan crash. Pemulihan crash akan terjadi pada upaya berikutnya untuk menginisialisasi instans tersebut.

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
JetTerm2