JetEndSession-Funktion
Gilt für: Windows | Windows Server
JetEndSession-Funktion
Die JetEndSession-Funktion beendet die Sitzung und bereinigt alle Ressourcen, die der angegebenen Sitzung zugeordnet sind, und gibt deren Verlagerung wieder auf.
JET_ERR JET_API JetEndSession(
__in JET_SESID sesid,
__in JET_GRBIT grbit
);
Parameter
sesid
Die zu beendende Sitzung. Zugeordnete Ressourcen werden freigegeben, wenn die Sitzung beendet wird.
grbit
Reserviert. Dieser Parameter kann das JET_bitForceSessionClosed enthalten, aber dieses Flag ist reserviert, und das Festlegen hat keine Auswirkungen.
Rückgabewert
Diese Funktion gibt den JET_ERR datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
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 von JetStopService beendet wurden. |
JET_errInvalidParameter |
Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert, oder die Kombination mehrerer Parameterwerte führte zu einem unerwarteten Ergebnis. |
JET_errInvalidSesid |
Die Sitzung war keine gültige JET-Sitzung. |
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete Instanz noch nicht initialisiert wurde. |
JET_errOutOfMemory |
Fehler beim Vorgang, weil der Arbeitsspeicher nicht zugeordnet werden konnte. |
JET_errSessionInUse |
Dies bedeutet, dass die Sitzung in einem anderen Thread verwendet wurde oder die Sitzung nicht ordnungsgemäß festgelegt oder zurückgesetzt wurde. |
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. Dieser Fehler wird nur von xp Windows und späteren Versionen zurückgegeben. |
JET_errOutOfBuffers |
Systemfehler, der angibt, dass keine Puffer mehr sind. |
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. |
Bei Erfolg wird das Sitzungshandy geschlossen und ist nicht verfügbar, und alle Ressourcen im Zusammenhang mit dieser Sitzung werden bereinigt.
Bei einem Fehler gibt es mehrere zusätzliche Fehler, die im Rahmen des Schließens der Sortiertabelle, des Schließens des Cursors und des Transaktionsrollbacks auftreten können. Diese Fehler sind ziemlich unwahrscheinlich und äußerst unwahrscheinlich, wenn Ihre Sitzungen vollständig nicht verwendet werden, wenn JetEndSession aufgerufen wird. Diese Fehler werden zurückgegeben, wenn ein Teil der Sitzung nicht ordnungsgemäß bereinigt werden konnte.
Hinweise
Diese API gibt ein Rollback für alle offenen Transaktionen aus (kein Committed auf Ebene 0). Außerdem werden alle Cursor, die dieser Sitzung zugeordnet sind, und alle Sortiertabellen, die erstellt oder geöffnet wurden, bereinigt.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server. |
Header |
Wird in Esent.h deklariert. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
JET_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService