Funzione JetEnableMultiInstance
Si applica a: Windows | Windows Server
Funzione JetEnableMultiInstance
La funzione JetEnableMultiInstance configura il motore di database da usare con più istanze nello stesso processo. Una matrice facoltativa di parametri di sistema globali è disponibile per il primo chiamante che consente la modifica alla modalità multiistanza.
Windows XP: JetEnableMultiInstance viene introdotto in Windows XP.
JET_ERR JET_API JetEnableMultiInstance(
__in_opt JET_SETSYSPARAM* psetsysparam,
__in_opt unsigned long csetsysparam,
__out_opt unsigned long* pcsetsucceed
);
Parametri
psetsysparam
Matrice di parametri di sistema globali da impostare se e solo se il motore entra in modalità multiistanza a causa di questa chiamata. Se csetsysparam è zero, psetsysparam viene ignorato.
csetsysparam
Numero di elementi per la matrice di parametri globali da impostare se e solo se il motore entra in modalità multiistanza come risultato di questa chiamata. Se csetsysparam è zero, psetsysparam viene ignorato.
pcsetsucceed
Puntatore al conteggio dei parametri di sistema globali configurati correttamente come risultato di questa chiamata.
Valore restituito
Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.
Codice restituito |
Descrizione |
|---|---|
JET_errSuccess |
Operazione riuscita. |
JET_errIndexTuplesInvalidLimits |
I parametri di indice tuple specificati non sono consentiti. Questo errore può essere restituito da JetEnableMultiInstance solo quando si impostano JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax o JET_paramIndexTuplesToIndexMax su un valore non valido. Windows XP: Questo valore restituito viene introdotto in Windows XP. |
JET_errInvalidPath |
Il percorso del file system specificato non è valido. Questo errore può essere restituito da JetEnableMultiInstance solo quando si impostano i parametri di sistema che rappresentano i percorsi del file system. Ad esempio, JET_paramSystemPath può restituire questo errore. |
JET_errRunningInOneInstanceMode |
L'operazione non è riuscita perché è illegale quando il motore di database è operativo in modalità singola istanza (modalità di compatibilità di Windows 2000). |
JET_errSystemParamsAlreadySet |
JetEnableMultiInstance non è riuscito perché il motore è già in modalità multiistanza. Nota Ciò avviene anche se non vengono specificati parametri di sistema. |
Se questa funzione ha esito positivo, il motore di database verrà configurato per l'esecuzione in modalità multiistanza. Il motore è stato configurato correttamente con l'elenco facoltativo dei parametri di sistema globali.
Se questa funzione ha esito negativo, il motore di database rimarrà nella modalità corrente. Se pcsetsucceed è diverso da zero, tale numero di parametri di sistema rimarrà impostato.
Commenti
Questa funzione deve essere usata solo se l'applicazione deve configurare un determinato set di parametri di sistema in modo atomico durante la configurazione del motore di database da usare in uno scenario multiutente nello stesso processo. Se è disponibile un altro metodo di sincronizzazione, è preferibile chiamare JetCreateInstance e JetSetSystemParameter separatamente.
Requisiti
| Requisito | Valore |
|---|---|
Client |
Richiede Windows Vista o Windows XP. |
Server |
Richiede Windows Server 2008 o Windows Server 2003. |
Intestazione |
Dichiarato in Esent.h. |
Libreria |
Usare ESENT.lib. |
DLL |
Richiede ESENT.dll. |
Unicode |
Implementato come JetEnableMultiInstanceW (Unicode) e JetEnableMultiInstanceA (ANSI). |
Vedere anche
JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter