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 instance ignoriert, und die der Sitzung zugeordnete instance wird verwendet.

Sesparamid

Die ID des festzulegenden Sitzungsparameters.

pvParam

Die in diesem Sitzungsparameter festzulegenden Daten.

cbParam

Die Größe der bereitgestellten Daten.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der in der folgenden Tabelle aufgeführten Rückgabecodes zurück. Weitere Informationen zu möglichen Ese-Fehlern (Extensible Storage Engine) finden Sie unter Fehler der erweiterbaren Speicher-Engine und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errAlreadyInitialized	Die instance 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 nach einer Änderung des Parameterwerts zu konfigurieren, den Zustand der Datenbank-Engine nicht mehr beeinflussen kann.
JET_errClientRequestToStopJetService	Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf dem instance, die der Sitzung zugeordnet sind, aufgrund eines Aufrufs der JetStopService-Funktion beendet wurden.
JET_errIndexTuplesInvalidLimits	Die angegebenen Tupelindexparameter waren unzulässig. Dieser Fehler wird nur zurückgegeben, wenn der parameter JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax oder JET_paramIndexTuplesToIndexMax auf einen unzulässigen Wert festgelegt ist. Informationen zu diesen Parametern finden Sie unter Indexparameter.
JET_errInitInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance initialisiert wird.
JET_errInstanceUnavailable	Es ist nicht möglich, den Vorgang abzuschließen, da für die instance, die der Sitzung zugeordnet ist, 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 Zeichenfolgenwertsystemparameter mit einer Zeichenfolge festzulegen, deren Länge außerhalb des zulässigen Bereichs für den Parameter lag. Es wurde versucht, einen Systemparameter mit Zeichenfolgenwert mit einem Dateipfad festzulegen, bei dem die Länge der absoluten Pfaddarstellung außerhalb des gesetzlichen Bereichs für diesen Parameter lag. Es wurde versucht, einen ganzzahligen Systemparameter mit einer ganzen Zahl festzulegen, die außerhalb des zulässigen Bereichs für den Parameter lag. Es wurde versucht, JET_paramUnicodeIndexDefault mit einem NULL-JET_UNICODEINDEX-Zeiger , einer ungültigen LCID oder einem nicht unterstützten Satz von LCMapString-Flags festzulegen. 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 Single-instance-Modus befindet und keine Sitzung angegeben wurde. Der angegebene Systemparameter ist nur global, und es wurde versucht, einen instance spezifischen Wert für diesen Systemparameter festzulegen. Der angegebene Systemparameter ist nur pro instance, und es wurde versucht, den globalen Wert für diesen Systemparameter festzulegen.
JET_errInvalidPath	Der angegebene Dateisystempfad war ungültig. Dieser Fehler kann von JetSetSessionParameter nur zurückgegeben werden, wenn Systemparameter festgelegt werden, die Dateisystempfade darstellen. Beispielsweise gibt der parameter JET_paramSystemPath diesen Fehler zurück. Informationen zu diesem Parameter finden Sie unter Transaktionsprotokollparameter.
JET_errNotInitialized	Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance noch nicht initialisiert wurde.
JET_errRestoreInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da ein Wiederherstellungsvorgang für die instance ausgeführt wird, die der Sitzung zugeordnet ist.
JET_errTermInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance heruntergefahren wird.
JET_errInvalidSesid	Das Sitzungshandle ist ungültig oder bezieht sich auf eine geschlossene Sitzung. Dieser Fehler wird nicht unter allen Umständen zurückgegeben. Handles werden nur auf der Grundlage des bestmöglichen Aufwands überprüft.
JET_errInvalidInstance	Das instance Handle ist ungültig oder bezieht sich auf eine heruntergefahrene instance. Dieser Fehler wird nicht unter allen Umständen zurückgegeben. Handles werden nur auf der Grundlage des bestmöglichen Aufwands überprüft.

Bei Erfolg wird der Systemparameter auf den angegebenen Wert festgelegt.

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

Anforderungen

Anforderung	Wert
Client	Erfordert Windows 8.
Server	Erfordert Windows Server 2012.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Siehe auch

JET_API_PTR
JET_ERR
JET_INSTANCE
JET_SESID
JetCreateInstance
JetGetSystemParameter
JetInit
Systemparameter