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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk