Fungsi JetStopService

Berlaku untuk: Windows | Windows Server

Fungsi JetStopService

Fungsi JetStopService menyiapkan instans untuk penghentian.

JetStopService adalah panggilan warisan ketika hanya satu instans yang diizinkan. Dalam hal ini, satu-satunya instans aktif adalah instans yang sedang disiapkan untuk penghentian.

    JET_ERR JET_API JetStopService(void);

Parameter

Fungsi ini tidak memiliki parameter.

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_errRunningInMultiInstanceMode	Tidak jelas instans mana yang harus dipersiapkan untuk penghentian saat menggunakan JetStopService dengan beberapa mode instans. Windows XP: Nilai yang dikembalikan ini diperkenalkan di Windows XP.

Jika fungsi ini berhasil, fungsi ini mempersiapkan 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 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, 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_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2