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:
|
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