Bagikan melalui


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