Fungsi JetEndExternalBackupInstance

Berlaku untuk: Windows | Windows Server

Fungsi JetEndExternalBackupInstance

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

Windows XP: JetEndExternalBackupInstance diperkenalkan di Windows XP.

    JET_ERR JET_API JetEndExternalBackupInstance(
      __in          JET_INSTANCE instance
    );

Parameter

Sebagai contoh

Instans yang digunakan untuk panggilan ini.

Windows 2000: Untuk Windows 2000, varian API yang menerima parameter ini tidak tersedia karena hanya satu instans yang didukung. Penggunaan instans global yang satu ini tersirat dalam kasus ini.

Windows XP: Untuk rilis Windows XP dan yang lebih baru, varian API yang tidak menerima parameter ini hanya dapat dipanggil ketika mesin berada dalam mode warisan (mode kompatibilitas Windows 2000) di mana hanya satu instans yang didukung. Jika tidak, operasi akan gagal dengan JET_errRunningInMultiInstanceMode.

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_errBackupAbortByCaller	Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP. Penelepon menghentikan cadangan di tengah urutan cadangan tanpa memberi sinyal niat dengan JetStopBackup. Kesalahan ini adalah hasil 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_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.
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 mengharuskan akses ke semua data dicabut untuk melindungi integritas data tersebut.
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 berhasil, cadangan 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 klien atau kesalahan penggunaan aplikasi. Penting untuk memeriksa kode pengembalian untuk 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 pemotongan log tidak dilakukan, mesin menganggap bahwa cadangan adalah cadangan salinan. Namun, cadangan mungkin merupakan cadangan normal yang pemotongannya tidak dilakukan (misalnya, jika ada database yang terlepas). Opsi JET_bitBackupTruncateDone dapat digunakan untuk memberi tahu mesin tentang hal ini dan memungkinkan modifikasi header database yang tepat.

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.

Lihat juga

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