Fungsi JetTruncateLog

Berlaku untuk: Windows | Windows Server

Fungsi JetTruncateLog

Fungsi JetTruncateLog digunakan selama pencadangan yang dimulai oleh JetBeginExternalBackup untuk menghapus file log transaksi apa pun yang tidak akan lagi diperlukan setelah pencadangan saat ini berhasil diselesaikan.

    JET_ERR JET_API JetTruncateLog(void);

Parameter

Fungsi ini tidak memiliki parameter.

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_errBackupAbortByServer	Operasi gagal karena cadangan eksternal saat ini telah dibatalkan oleh panggilan ke JetStopBackup. Windows Server 2003: Nilai pengembalian ini diperkenalkan di Windows Server 2003.
JET_errClientRequestToStopJetService	Operasi tidak dapat diselesaikan karena semua aktivitas pada instans yang terkait dengan sesi telah berhenti sebagai akibat dari panggilan ke JetStopService.
JET_errInstanceUnavailable	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi mengalami kesalahan fatal yang mengharuskan akses ke semua data dicabut untuk melindungi integritas data tersebut. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP.
JET_errInvalidBackupSequence	Operasi pencadangan gagal karena dipanggil secara berurutan. JetTruncateLog akan mengembalikan kesalahan ini jika ada handel file luar biasa yang dibuat menggunakan JetOpenFile untuk instans.
JET_errInvalidParameter	Salah satu parameter yang disediakan berisi nilai yang tidak terduga, atau kombinasi beberapa parameter menghasilkan hasil yang tidak terduga. Ini dapat terjadi untuk JetTruncateLog ketika handel instans yang ditentukan tidak valid. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP.
JET_errNoBackup	Operasi gagal karena tidak ada pencadangan eksternal yang sedang berlangsung.
JET_errNotInitialized	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi belum diinisialisasi.
JET_errRestoreInProgress	Operasi tidak dapat diselesaikan karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.
JET_errRunningInMultiInstanceMode	Operasi gagal karena upaya dilakukan untuk menggunakan mesin dalam mode warisan (mode kompatibilitas Windows 2000) di mana hanya satu instans yang didukung, padahal sebenarnya beberapa instans sudah ada.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan.

Jika fungsi ini berhasil, kumpulan file log transaksi yang tidak akan lagi diperlukan setelah pencadangan saat ini berhasil dihapus. Komputer status pencadangan akan dimajukan sehingga pencadangan file database tidak lagi diizinkan. Hanya file patch database dan file log transaksi yang diizinkan untuk dibuka untuk pencadangan di luar titik ini.

Jika fungsi ini gagal, komputer status pencadangan dapat dimajukan sehingga pencadangan file database tidak lagi diizinkan. Beberapa jumlah file log transaksi mungkin dihapus yang kurang dari angka yang diinginkan, tetapi akan selalu dihapus dari yang terlama hingga termuda.

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
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService