Fungsi JetIdle

Berlaku untuk: Windows | Windows Server

Fungsi JetIdle

Fungsi JetIdle tidak berfungsi, dan hanya boleh digunakan untuk tujuan pengujian. JetIdle dapat digunakan untuk melakukan tugas pembersihan diam atau memeriksa status penyimpanan versi di ESE.

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

Sesi yang akan digunakan untuk panggilan ini.

grbit

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

Nilai

Makna

JET_bitIdleCompact

Memicu pembersihan penyimpanan versi.

JET_bitIdleFlushBuffers

Disiapkan untuk penggunaan masa mendatang. Jika bendera ini ditentukan, API akan mengembalikan JET_errInvalidgrbit.

JET_bitIdleStatus

Mengembalikan JET_wrnIdleFull jika penyimpanan versi lebih dari setengah penuh.

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

Parameter grbit yang diberikan ke API tidak valid.

Jika fungsi ini berhasil, operasi yang sesuai akan dipicu, atau kode kesalahan yang menunjukkan seberapa lengkap penyimpanan versi tergantung pada grbit yang disediakan.

Jika fungsi ini gagal, operasi yang diminta tidak akan berhasil diselesaikan.

Keterangan

Penyimpanan versi mempertahankan mekanisme isolasi rekam jepret ESE. Jika penyimpanan versi lebih dari setengah penuh, program mungkin menutup transaksi yang berjalan lama. Jika transaksi yang berjalan lama menghabiskan penyimpanan versi, ESE akan berhenti mengizinkan operasi tulis ke database.

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

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction