Fungsi JetStopBackupInstance

Berlaku untuk: Windows | Windows Server

Fungsi JetStopBackupInstance

Fungsi JetStopBackupInstance mencegah aktivitas terkait pencadangan streaming berlanjut pada instans tertentu yang berjalan, sehingga mengakhiri pencadangan streaming dengan cara yang dapat diprediksi.

Windows XP:JetStopBackupInstance diperkenalkan di Windows XP.

    JET_ERR JET_API JetStopBackupInstance(
      __in          JET_INSTANCE instance
    );

Parameter

Sebagai contoh

Mengidentifikasi instans yang sedang berjalan untuk digunakan untuk panggilan API.

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	Parameter instans yang ditentukan memiliki nilai yang tidak valid (bukan instans yang saat ini berjalan). Windows XP: Nilai yang dikembalikan ini diperkenalkan di Windows XP.

Jika fungsi ini berhasil, instans yang ditentukan akan mulai gagal pada API cadangan streaming baru.

Jika fungsi ini gagal, tidak ada langkah-langkah untuk mempersiapkan penghentian cadangan pada instans yang akan diambil dan tidak ada perubahan pada status instans yang akan terjadi.

Keterangan

Pencadangan biasanya dipicu oleh peristiwa di luar mekanisme proses dan dengan menggunakan API ini, aplikasi ESENT itu sendiri akan melakukan panggilan lebih lanjut ke API cadangan streaming untuk gagal. Sebagian besar API cadangan streaming akan mulai gagal dengan JET_errBackupAbortByServer. Dengan demikian, setiap kemajuan pencadangan streaming (seperti JetReadFileInstance) akan mengembalikan kesalahan. Operasi pencadangan yang merupakan bagian dari penghentian cadangan (seperti JetEndExternalBackupInstance) masih akan diizinkan.

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

JET_ERR
JET_INSTANCE
JetEndExternalBackupInstance
JetReadFileInstance
JetStopService