Fungsi JetEndExternalBackup

Berlaku untuk: Windows | Windows Server

Fungsi JetEndExternalBackup

Fungsi JetEndExternalBackup mengakhiri sesi pencadangan eksternal. Fungsi ini adalah elemen API terakhir dalam serangkaian elemen API yang harus dipanggil untuk menjalankan pencadangan online yang berhasil (berbasis non-VSS).

    JET_ERR JET_API JetEndExternalBackup(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_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	Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi mengalami kesalahan fatal yang memerlukan akses ke semua data dicabut untuk melindungi integritas data tersebut.
JET_errTermInProgress	Operasi tidak dapat diselesaikan karena instans yang terkait dengan sesi sedang dimatikan.
JET_errRestoreInProgress	Operasi tidak dapat diselesaikan karena operasi pemulihan sedang berlangsung pada instans yang terkait dengan sesi.
JET_errNoBackup	Operasi gagal karena tidak ada pencadangan eksternal yang sedang berlangsung.
JET_errBackupAbortByServer	Windows Server 2003: Nilai pengembalian ini diperkenalkan di Windows Server 2003. Operasi gagal karena cadangan eksternal saat ini telah dibatalkan oleh panggilan ke JetStopBackup.
errBackupAbortByCaller	Windows XP: Nilai yang dikembalikan ini diperkenalkan di Windows XP. Penelepon menghentikan cadangan di tengah urutan cadangan tanpa memberi sinyal niat dengan JetStopBackup. Kesalahan ini adalah akibat dari bug di klien cadangan di Windows Server 2003 dan yang lebih baru. Pada Windows XP, kesalahan ini dikembalikan untuk penghentian urutan cadangan eksternal yang disengaja.
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.

Jika fungsi ini berhasil, pencadangan eksternal berhasil. Keberhasilan menunjukkan bahwa semua file (misalnya, database dan log) yang sesuai untuk jenis cadangan (ditentukan dalam JetBeginExternalBackup) diambil dari mesin cadangan. File yang dicadangkan dapat dipulihkan dengan pemulihan keras (JetExternalRestore).

Jika fungsi ini gagal, pencadangan eksternal biasanya berakhir. Kegagalan berarti bahwa pencadangan tidak valid karena kesalahan penggunaan klien atau aplikasi. Penting untuk memeriksa kode pengembalian api ini untuk memverifikasi bahwa urutan cadangan berhasil.

Keterangan

Jika mesin dikonfigurasi untuk mencatat peristiwa, peristiwa dicatat untuk menunjukkan resolusi cadangan eksternal.

Jika urutan cadangan tidak selesai secara berurutan dan dengan panggilan yang berhasil ke JetEndExternalBackup, cadangan inkremental berikutnya mungkin berisi lebih banyak data daripada yang diantisipasi aplikasi.

Untuk informasi selengkapnya tentang urutan API cadangan eksternal, lihat JetBeginExternalBackup.

Sebelum Windows Vista, jika pemotokan log tidak dilakukan, mesin menganggap bahwa cadangan adalah cadangan salinan. Namun, pencadangan mungkin merupakan cadangan normal yang pemotokannya tidak dilakukan (misalnya, jika ada database yang dilepaskan). Opsi JET_bitBackupTruncateDone dapat digunakan untuk memberi tahu mesin tentang hal ini dan memungkinkan modifikasi header database yang sesuai.

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

Parameter Penanganan Kesalahan
Kesalahan Mesin Penyimpanan yang Dapat Diperluas
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog