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