Fungsi JetBeginExternalBackupInstance

Berlaku untuk: Windows | Windows Server

Fungsi JetBeginExternalBackupInstance

Fungsi JetBeginExternalBackupInstance memulai pencadangan eksternal saat mesin dan database online dan aktif.

Windows XP: JetBeginExternalBackupInstance diperkenalkan di Windows XP.

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

Parameter

Sebagai contoh

Instans database yang digunakan untuk panggilan ini.

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.

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_bitBackupAtomic	Bendera ini tidak digunakan lagi. Penggunaan bit ini akan mengakibatkan JET_errInvalidgrbit dikembalikan.
JET_bitBackupIncremental	Membuat cadangan inkremental dibandingkan dengan pencadangan penuh. Ini berarti bahwa hanya file log sejak pencadangan penuh atau bertahap terakhir yang akan dicadangkan.
JET_bitBackupSnapshot	Disiapkan untuk penggunaan masa mendatang. Ditentukan untuk Windows XP.

Tampilkan Nilai

Sistem dapat menghasilkan kode keberhasilan atau kegagalan sebagai akibat dari panggilan ke fungsi ini. Untuk daftar lengkap kesalahan untuk API ini, lihat Kode Kesalahan Mesin Penyimpanan yang Dapat Diperluas.

Lihat JetBeginExternalBackup.

Keterangan

JetBeginExternalBackupInstance adalah fungsi pertama dalam serangkaian fungsi yang harus dipanggil untuk menjalankan pencadangan online yang berhasil (berbasis non-VSS). Lihat juga JetBeginExternalBackup dan JetStopBackupInstance.

Cadangan eksternal dapat digunakan untuk menerapkan pencadangan penuh, inkremental, atau diferensial.

Cadangan akan fuzzy, karena cadangan akan konsisten ke satu titik waktu dalam riwayat transaksi, tetapi mengontrol titik waktu yang tepat tidak dimungkinkan saat ini.

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

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog