JetResetSessionContext-Funktion

Gilt für: Windows | Windows Server

JetResetSessionContext-Funktion

Die JetResetSessionContext-Funktion entfernt die Zuordnung einer Sitzung zum aktuellen Thread.

    JET_ERR JET_API JetResetSessionContext(
      __in          JET_SESID sesid
    );

Parameter

sesid

Die Sitzung, die für diesen Aufruf verwendet werden soll.

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_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_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_errSessionContextNotSetByThisThread

Die Zuordnung der Sitzung zum aktuellen Thread konnte nicht aufgehoben werden, da sie einem anderen Thread zugeordnet ist.

JET_errTermInProgress

Es ist nicht möglich, den Vorgang abzuschließen, da die der Sitzung zugeordnete instance heruntergefahren wird.

Bei Erfolg wird die Zuordnung der Sitzung zum aktuellen Thread aufgehoben. Es wird keine Änderung des Datenbankzustands vorgenommen.

Bei einem Fehler bleibt der Sitzungszustand unverändert. Es wird keine Änderung des Datenbankzustands vorgenommen.

Bemerkungen

JetResetSessionContext muss für denselben Thread aufgerufen werden, der jetSetSessionContext für eine bestimmte Sitzung aufgerufen hat.

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_API_PTR
JET_ERR
JET_SESID
JetSetSessionContext