Fungsi JetEndExternalBackupInstance2

Berlaku untuk: Windows | Windows Server

Fungsi JetEndExternalBackupInstance2

Fungsi JetEndExternalBackupInstance2 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: JetEndExternalBackupInstance2 diperkenalkan di Windows XP.

    JET_ERR JET_API JetEndExternalBackupInstance2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

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.

grbit

Sekelompok bit yang menentukan nol atau beberapa opsi berikut.

Nilai	Makna
JET_bitBackupEndAbort 0x0002	Aplikasi klien membatalkan pencadangan.
JET_bitBackupEndNormal 0x0001	Aplikasi klien menyelesaikan pencadangan sepenuhnya, dan berakhir secara normal.
JET_bitBackupTruncateDone 0x0100	Windows Vista: JET_bitBackupTruncateDone diperkenalkan di Windows Vista. Mesin dapat menandai header database yang sesuai (misalnya, pencadangan penuh selesai), meskipun panggilan untuk memotong tidak selesai.

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 yang dikembalikan ini diperkenalkan di Windows XP. Penelepon menghentikan cadangan di tengah urutan cadangan tanpa memberi sinyal niat dengan JetStopBackup. Kesalahan ini disebabkan oleh bug di klien cadangan di Windows Server 2003 dan yang lebih baru. Di 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 yang dikembalikan 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, 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 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
JET_ERR
JET_GRBIT
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog