JetEnableMultiInstance-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetEnableMultiInstance-Funktion
Die Funktion JetEnableMultiInstance wird die Datenbank-Engine für die Verwendung mit mehreren Instanzen in demselben Prozess konfiguriert. Ein optionales Array von globalen Systemparameter ist für die erste Anrufer zulassen, damit die Änderung mit mehreren Instanzen verfügbar.
Windows XP:JetEnableMultiInstance wird in Windows XP eingeführt.
JET_ERR JET_API JetEnableMultiInstance(
__in_opt JET_SETSYSPARAM* psetsysparam,
__in_opt unsigned long csetsysparam,
__out_opt unsigned long* pcsetsucceed
);
Parameter
psetsysparam
Ein Array von globalen Systemparameter festlegen, wenn das Modul mit mehreren Instanzen Modus als Ergebnis dieses Aufrufs eingibt. Wenn Csetsysparam gleich null ist, wird Psetsysparam ignoriert.
csetsysparam
Die Anzahl der Elemente für das Array von globalen Parameter festlegen, wenn das Modul mit mehreren Instanzen Modus als Ergebnis dieses Aufrufs eingibt. Wenn Csetsysparam gleich null ist, wird Psetsysparam ignoriert.
pcsetsucceed
Ein Zeiger auf die Anzahl der globalen Systemparameter, die als Ergebnis dieses Aufrufs erfolgreich konfiguriert wurden.
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errIndexTuplesInvalidLimits |
Die Index-Parameter angegebenen Tupel wurden nicht zulässig. Dieser Fehler kann durch JetEnableMultiInstance zurückgegeben werden nur beim JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMaxoder JET_paramIndexTuplesToIndexMax auf einen ungültigen Wert festlegen. Windows XP: Dieser Wert wird in Windows XP eingeführt. |
JET_errInvalidPath |
Der angegebenen Dateisystempfad war ungültig. Dieser Fehler kann durch JetEnableMultiInstance zurückgegeben werden nur beim Systemparameter festlegen, die Systemdateipfade darstellen. Beispielsweise können JET_paramSystemPath dieser Fehler zurückgegeben. |
JET_errRunningInOneInstanceMode |
Der Vorgang fehlgeschlagen ist, da es ungültig ist, wenn die Datenbank-Engine in Einzelinstanz-Modus (Windows 2000-Kompatibilitätsmodus) ausgeführt wird. |
JET_errSystemParamsAlreadySet |
JetEnableMultiInstance ist fehlgeschlagen, da das Modul bereits mit mehreren Instanzen ist. HinweisDies geschieht, auch wenn keine Systemparameter angegeben werden. |
Wenn diese Funktion erfolgreich ist, wird die Datenbank-Engine für die Ausführung mit mehreren Instanzen konfiguriert werden. Das Modul wurde mit den optionalen Liste mit globalen Systemparameter auch erfolgreich konfiguriert.
Wenn diese Funktion fehlschlägt, bleibt die Datenbank-Engine im aktuellen Modus. Wenn Pcsetsucceed ungleich NULL ist, wird die Anzahl der Systemparameter festgelegt bleiben.
Anmerkungen
Diese Funktion sollte nur verwendet werden, wenn die Anwendung eine gegebenen Reihe von Systemparameter automatisch konfiguriert werden muss die Datenbank-Engine für die Verwendung in einem Szenario mit mehreren Benutzern in demselben Prozess einrichten. Wenn eine andere Methode der Synchronisierung verfügbar ist, ist es vorzuziehen JetCreateInstance und JetSetSystemParameter aufrufen.
Voraussetzungen
-Client, |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert WindowsServer 2008 oder WindowsServer 2003. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Unicode |
Implementiert als JetEnableMultiInstanceW (Unicode) und JetEnableMultiInstanceA (ANSI). |
Siehe auch
JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter