Fungsi JetGetTruncateLogInfoInstance

Berlaku untuk: Windows | Windows Server

Fungsi JetGetTruncateLogInfoInstance

Fungsi JetGetTruncateLogInfoInstance digunakan selama pencadangan yang dimulai oleh JetBeginExternalBackup untuk mengkueri instans untuk nama file log transaksi yang dapat dihapus dengan aman setelah cadangan berhasil diselesaikan.

Windows XP:JetGetTruncateLogInfoInstance diperkenalkan di Windows XP.

    JET_ERR JET_API JetGetTruncateLogInfoInstance(
      __in          JET_INSTANCE instance,
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

Parameter

Sebagai contoh

Instans yang digunakan untuk panggilan ini.

szz

Buffer output yang menerima daftar string yang dihentikan null yang menjelaskan kumpulan file log transaksi yang dapat dihapus dengan aman setelah pencadangan berhasil diselesaikan.

Daftar string yang dikembalikan dalam buffer ini dalam format yang sama dengan multi-string yang digunakan oleh registri. Setiap string yang dihentikan null dikembalikan secara berurutan dan diikuti oleh terminator null akhir.

cbMax

Ukuran maksimum dalam byte dari buffer output.

pcbActual

Penunjuk ke buffer output yang menerima jumlah data string aktual.

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 nilai parameter menghasilkan hasil yang tidak terduga. Windows XP dan yang lebih baru: Ini dapat terjadi untuk JetGetTruncateLogInfoInstance ketika handel instans yang ditentukan tidak valid.
JET_errNotInitialized	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi belum diinisialisasi.
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_errBackupAbortByServer	Operasi gagal karena cadangan eksternal saat ini telah dibatalkan oleh panggilan ke JetStopBackup. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP.
JET_errInvalidBackupSequence	Operasi pencadangan gagal karena dipanggil keluar dari urutan.
JET_errNoBackup	Operasi gagal karena tidak ada pencadangan eksternal yang sedang berlangsung.
JET_errRestoreInProgress	Operasi tidak dapat diselesaikan karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan.
JetGetTruncateLogInfoInstance	Ada handel file luar biasa yang dibuat menggunakan JetOpenFile untuk instans.

Jika fungsi ini berhasil, informasi yang diminta tentang kumpulan file log transaksi yang dapat dihapus dengan aman setelah cadangan berhasil diselesaikan akan ditempatkan di buffer output tempat mereka disediakan. Komputer status pencadangan akan dimajukan sehingga pencadangan file database tidak lagi diizinkan. Hanya file patch database dan file log transaksi yang dapat dibuka untuk pencadangan di luar titik ini.

Jika fungsi ini gagal, status buffer output tidak terdefinisi. Kegagalan akan mengakibatkan pembatalan seluruh proses pencadangan untuk instans.

Keterangan

API ini tidak mengembalikan kesalahan atau peringatan jika buffer output terlalu kecil untuk menerima daftar lengkap file yang harus menjadi bagian dari kumpulan file cadangan. Aplikasi harus selalu menyediakan buffer untuk menerima ukuran aktual daftar ini dan menggunakan informasi tersebut untuk menentukan apakah daftar terpotok.

Persyaratan

Persyaratan	Nilai
Klien	Memerlukan Windows Vista atau Windows XP.
Server	Memerlukan Windows Server 2008 atau Windows Server 2003.
Header	Dinyatakan dalam Esent.h.
Pustaka	Gunakan ESENT.lib.
DLL	Membutuhkan ESENT.dll.
Unicode	Diimplementasikan sebagai JetGetTruncateLogInfoInstanceW (Unicode) dan JetGetTruncateLogInfoInstanceA (ANSI).

Lihat juga

JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetCloseDatabase
JetCloseTable
JetEndSession
JetOpenFile
JetResetSessionContext
JetRollback
JetStopBackup
JetStopService
JetTerm
JetTerm2