Fungsi JetEnableMultiInstance

Artikel
06/13/2023

Berlaku untuk: Windows | Windows Server

Fungsi JetEnableMultiInstance

Fungsi JetEnableMultiInstance mengonfigurasi mesin database untuk digunakan dengan beberapa instans dalam proses yang sama. Array opsional parameter sistem global tersedia untuk pemanggil pertama yang memungkinkan perubahan ke mode multi-instans.

Windows XP: JetEnableMultiInstance diperkenalkan di Windows XP.

    JET_ERR JET_API JetEnableMultiInstance(
      __in_opt      JET_SETSYSPARAM* psetsysparam,
      __in_opt      unsigned long csetsysparam,
      __out_opt     unsigned long* pcsetsucceed
    );

Parameter

psetsysparam

Array parameter sistem global untuk diatur jika dan hanya jika mesin memasuki mode multi-instans sebagai akibat dari panggilan ini. Jika csetsysparam nol, maka psetsysparam diabaikan.

csetsysparam

Jumlah elemen untuk array parameter global yang akan diatur jika dan hanya jika mesin memasuki mode multi-instans sebagai akibat dari panggilan ini. Jika csetsysparam nol, maka psetsysparam diabaikan.

pcsetsucceed

Penunjuk ke hitungan parameter sistem global yang berhasil dikonfigurasi sebagai akibat dari panggilan ini.

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_errIndexTuplesInvalidLimits	Parameter indeks tuple yang ditentukan tidak diizinkan. Kesalahan ini hanya dapat dikembalikan oleh JetEnableMultiInstance saat mengatur JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax, atau JET_paramIndexTuplesToIndexMax ke nilai ilegal. Windows XP: Nilai pengembalian ini diperkenalkan di Windows XP.
JET_errInvalidPath	Jalur sistem file yang ditentukan tidak valid. Kesalahan ini dapat dikembalikan oleh JetEnableMultiInstance hanya ketika mengatur parameter sistem yang mewakili jalur sistem file. Misalnya, JET_paramSystemPath dapat mengembalikan kesalahan ini.
JET_errRunningInOneInstanceMode	Operasi gagal karena ilegal ketika mesin database beroperasi dalam mode instans tunggal (mode kompatibilitas Windows 2000).
JET_errSystemParamsAlreadySet	JetEnableMultiInstance gagal karena mesin sudah dalam mode multi-instans. Catatan Ini akan terjadi bahkan jika tidak ada parameter sistem yang ditentukan.

Jika fungsi ini berhasil, mesin database akan dikonfigurasi untuk berjalan dalam mode multi-instans. Mesin juga berhasil dikonfigurasi dengan daftar opsional parameter sistem global.

Jika fungsi ini gagal, mesin database akan tetap berada dalam mode saat ini. Jika pcsetsucceed bukan nol, jumlah parameter sistem tersebut akan tetap diatur.

Keterangan

Fungsi ini hanya boleh digunakan jika aplikasi harus mengonfigurasi sekumpulan parameter sistem tertentu secara atomik saat menyiapkan mesin database untuk digunakan dalam skenario multi-pengguna dalam proses yang sama. Jika metode sinkronisasi lain tersedia, lebih baik memanggil JetCreateInstance dan JetSetSystemParameter secara terpisah.

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.
Unicode	Diimplementasikan sebagai JetEnableMultiInstanceW (Unicode) dan JetEnableMultiInstanceA (ANSI).

Lihat juga

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter

Bagikan melalui

Fungsi JetEnableMultiInstance