Fungsi JetStopServiceInstance

Berlaku untuk: Windows | Windows Server

Fungsi JetStopServiceInstance

Fungsi JetStopServiceInstance menyiapkan instans untuk penghentian.

Windows XP:JetStopServiceInstance diperkenalkan di Windows XP.

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

Parameter

Sebagai contoh

Instans yang sedang berjalan yang akan 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 pengembalian ini diperkenalkan di Windows XP.

Jika fungsi ini berhasil, fungsi ini bersiap untuk penghentian di masa mendatang. Langkah-langkah yang diambil untuk mempersiapkan penghentian meliputi hal-hal berikut:

• Hentikan defragmentasi online jika sedang berjalan.

• Mulai pembersihan penyimpanan versi.

• Kurangi kedalaman titik pemeriksaan dengan mulai membersihkan halaman kotor di manajer buffer.

• Mencegah panggilan di masa mendatang ke sebagian besar fungsi untuk instans tersebut.

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

Keterangan

Fungsi ini akan mengurangi pekerjaan yang harus dilakukan instans ketika dihentikan tetapi tidak akan mengakhiri instans. Akibatnya, fungsi ini hanyalah pengoptimalan dan tidak wajib digunakan. Perhatikan bahwa jumlah pekerjaan yang dilakukan dalam persiapan kurang di Windows 2000 dan Windows XP. Setelah fungsi berhasil, fungsi panggilan yang tidak lagi diizinkan akan mengembalikan JET_errClientRequestToStopJetService. Fungsi yang masih diizinkan setelah panggilan ini adalah: JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase , dan JetResetSessionContext.

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
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2