Freigeben über

JetEndSession-Funktion

  • Artikel

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 die Zuordnung 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 endet.

grbit

Reserviert. Dieser Parameter kann das flag JET_bitForceSessionClosed enthalten, dieses Flag ist jedoch reserviert, und das Festlegen hat keine Auswirkung.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errClientRequestToStopJetService

Es ist nicht möglich, den Vorgang abzuschließen, da alle Aktivitäten auf der instance, die der Sitzung zugeordnet sind, 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

Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance noch nicht initialisiert wurde.

JET_errOutOfMemory

Der Vorgang ist fehlgeschlagen, 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

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.

Dieser Fehler wird nur von Windows XP und späteren Versionen zurückgegeben.

JET_errOutOfBuffers

Systemfehler, der angibt, dass keine Puffer mehr vorhanden sind.

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.

Bei Erfolg ist das Sitzungshandle geschlossen und nicht verfügbar, und alle Ressourcen im Zusammenhang mit dieser Sitzung werden bereinigt.

Bei einem Fehler können mehrere zusätzliche Fehler auftreten, 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.

Bemerkungen

Diese API führt ein Rollback aller geöffneten Transaktionen durch (kein Commit 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.

Kopfzeile

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JET_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService