JetSetSessionParameter-Funktion

Gilt für: Windows | Windows Server

Die JetSetSessionParameter-Funktion konfiguriert die Datenbank-Engine.

JET_ERR JET_API JetSetSessionParameter (
  __in_opt      JET_SESID sesid,
  __in          unsigned long sesparamid,
  __in_read_bytes_opt_(cbParam)  void* pvParam,
  __in          unsigned long cbParam
);

Parameter

sesid

Gibt die Sitzung an, die für diesen Aufruf verwendet werden soll.

Wenn angegeben, wird die angegebene -Instanz ignoriert, und die der Sitzung zugeordnete -Instanz wird verwendet.

sespartrenn

Die ID des sitzungsparameters, der festgelegt werden soll.

pvParam

Die daten, die in diesem Sitzungsparameter festgelegt werden.

cbParam

Die Größe der bereitgestellten Daten.

Rückgabewert

Diese Funktion gibt den JET_ERR-Datentyp mit einem der in der folgenden Tabelle aufgeführten Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern (Extensible Storage Engine) finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errAlreadyInitialized

Die -Instanz wurde mithilfe eines Aufrufs der JetInit-Funktion initialisiert, und dieser Vorgang kann daher nicht ausgeführt werden. Dies kann passieren, wenn versucht wird, einen Systemparameter zu konfigurieren, nachdem eine Änderung des Parameterwerts den Zustand der Datenbank-Engine nicht mehr beeinflussen kann.

JET_errClientRequestToStopJetService

Es ist nicht möglich, den Vorgang abschließen, da alle Aktivitäten auf der Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs der JetStopService-Funktion beendet wurden.

JET_errIndexTuplesInvalidLimits

Die angegebenen Tupelindexparameter waren ungültig. Dieser Fehler wird nur zurückgegeben, wenn derJET_paramIndexTuplesLengthMin , JET_paramIndexTuplesLengthMaxoder JET_paramIndexTuplesToIndexMax parameter auf einen ungültigen Wert festgelegt ist. Informationen zu diesen Parametern finden Sie unter Indexparameter.

JET_errInitInProgress

Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz initialisiert wird.

JET_errInstanceUnavailable

Der Vorgang kann nicht abgeschlossen werden, da für die der Sitzung zugeordnete Instanz ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen.

JET_errInvalidParameter

Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert oder einen Wert, der in Kombination mit dem Wert eines anderen Parameters nicht sinnvoll war. Dies kann passieren, wenn Folgendes auftritt:

  • Die angegebene Systemparameter-ID ist ungültig oder wird nicht unterstützt.

  • Es wurde versucht, einen Systemparameter mit Zeichenfolgenwert mit einer Zeichenfolge zu setzen, deren Länge außerhalb des rechtlichen Bereichs für den Parameter lag.

  • Es wurde versucht, einen Systemparameter mit Zeichenfolgenwert mit einem Dateipfad zu setzen, bei dem die Länge seiner absoluten Pfaddarstellung außerhalb des rechtlichen Bereichs für diesen Parameter lag.

  • Es wurde versucht, einen Ganzzahlwert-Systemparameter mit einer ganzen Zahl zu setzen, die außerhalb des rechtlichen Bereichs für den Parameter liegt.

  • Es wurde versucht, eine -JET_paramUnicodeIndexDefault mit einem NULL JET_UNICODEINDEX zeiger, einer ungültigen LCID oder einem nicht unterstützten Satz von LCMapString-Flags zu setzen.

  • Der angegebene Systemparameter kann nicht festgelegt werden, da er schreibgeschützt ist.

  • Es wurde versucht, einen Systemparameter festzulegen, nachdem die JetInit-Funktion aufgerufen wurde, sich die Datenbank-Engine im Einzelinstanzmodus befindet und keine Sitzung angegeben wurde.

  • Der angegebene Systemparameter ist nur global, und es wurde versucht, einen instanzspezifischen Wert für diesen Systemparameter festzulegen.

  • Der angegebene Systemparameter gilt nur pro Instanz, und es wurde versucht, den globalen Wert für diesen Systemparameter festzulegen.

JET_errInvalidPath

Der angegebene Dateisystempfad war ungültig. Dieser Fehler kann nur von JetSetSessionParameter zurückgegeben werden, wenn Systemparameter festgelegt werden, die Dateisystempfade darstellen. Beispielsweise kann der JET_paramSystemPath-Parameter diesen Fehler zurückgeben. Informationen zu diesem Parameter finden Sie unter Transaktionsprotokollparameter.

JET_errNotInitialized

Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz noch nicht initialisiert wurde.

JET_errRestoreInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die -Instanz durchgeführt wird, die der Sitzung zugeordnet ist.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz heruntergefahren wird.

JET_errInvalidSesid

Das Sitzungshandy ist ungültig oder verweist auf eine geschlossene Sitzung.

Dieser Fehler wird nicht unter allen Umständen zurückgegeben. Handles werden nur nach bestem Aufwand überprüft.

JET_errInvalidInstance

Das Instanzhandy ist ungültig oder verweist auf eine heruntergefahrene Instanz.

Dieser Fehler wird nicht unter allen Umständen zurückgegeben. Handles werden nur nach bestem Aufwand überprüft.

Bei Erfolg wird der Systemparameter auf den angegebenen Wert festgelegt.

Bei einem Fehler bleibt der Wert des Systemparameters unverändert.

Anforderungen

| | |

Client

|

Erfordert Windows 8.

| |

Server

|

Erfordert Windows Server 2012.

| |

Header

|

Wird in Esent.h deklariert.

| |

Bibliothek

|

Verwenden Sie ESENT.lib.

| |

DLL

|

Erfordert ESENT.dll.

|

Weitere Informationen

JET_API_PTR
JET_ERR
JET_INSTANCE
JET_SESID
JetCreateInstance
JetGetSystemParameter
JetInit
Systemparameter