JetEnableMultiInstance-Funktion

Gilt für: Windows | Windows Server

JetEnableMultiInstance-Funktion

Die JetEnableMultiInstance-Funktion konfiguriert die Datenbank-Engine für die Verwendung mit mehreren Instanzen im selben Prozess. Ein optionales Array von globalen Systemparametern steht dem ersten Aufrufer zur Verfügung, der die Umstellung auf den Multi-instance-Modus ermöglicht.

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 Systemparametern, das nur dann festgelegt werden soll, wenn die Engine als Ergebnis dieses Aufrufs in den Modus mit mehreren instance wechselt. Wenn csetsysparam null ist, wird psetsysparam ignoriert.

csetsysparam

Die Anzahl der Elemente für das Array von globalen Parametern, die festgelegt werden sollen, wenn die Engine als Ergebnis dieses Aufrufs in den Modus mit mehreren instance wechselt. Wenn csetsysparam null ist, wird psetsysparam ignoriert.

pcsetsucceed

Ein Zeiger auf die Anzahl der globalen Systemparameter, die als Ergebnis dieses Aufrufs erfolgreich konfiguriert wurden.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errIndexTuplesInvalidLimits	Die angegebenen Tupelindexparameter waren nicht zulässig. Dieser Fehler kann von JetEnableMultiInstance nur zurückgegeben werden, wenn JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax oder JET_paramIndexTuplesToIndexMax auf einen unzulässigen Wert festgelegt wird. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.
JET_errInvalidPath	Der angegebene Dateisystempfad war ungültig. Dieser Fehler kann von JetEnableMultiInstance nur zurückgegeben werden, wenn Systemparameter festgelegt werden, die Dateisystempfade darstellen. Beispielsweise können JET_paramSystemPath diesen Fehler zurückgeben.
JET_errRunningInOneInstanceMode	Der Vorgang ist fehlgeschlagen, weil er nicht zulässig ist, wenn die Datenbank-Engine im Einzel-instance-Modus (Windows 2000-Kompatibilitätsmodus) ausgeführt wird.
JET_errSystemParamsAlreadySet	JetEnableMultiInstance ist fehlgeschlagen, da sich die Engine bereits im Multi-instance-Modus befindet. Hinweis Dies geschieht auch dann, wenn keine Systemparameter angegeben sind.

Wenn diese Funktion erfolgreich ist, wird die Datenbank-Engine für die Ausführung im Multi-instance-Modus konfiguriert. Die Engine wurde auch erfolgreich mit der optionalen Liste der globalen Systemparameter konfiguriert.

Wenn diese Funktion fehlschlägt, verbleibt die Datenbank-Engine im aktuellen Modus. Wenn pcsetsucceed ungleich 0 ist, bleibt diese Anzahl von Systemparametern festgelegt.

Bemerkungen

Diese Funktion sollte nur verwendet werden, wenn die Anwendung einen bestimmten Satz von Systemparametern atomar konfigurieren muss, wenn die Datenbank-Engine für die Verwendung in einem Mehrbenutzerszenario im selben Prozess eingerichtet wird. Wenn eine andere Synchronisierungsmethode verfügbar ist, empfiehlt es sich, JetCreateInstance und JetSetSystemParameter separat aufzurufen.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista oder Windows XP.
Server	Erfordert Windows Server 2008 oder Windows Server 2003.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.
Unicode	Implementiert als JetEnableMultiInstanceW (Unicode) und JetEnableMultiInstanceA (ANSI).

Weitere Informationen

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter