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