JetResetSessionContext Function

Applies to: Windows | Windows Server

The JetResetSessionContext function disassociates a session from the current thread.

    JET_ERR JET_API JetResetSessionContext(
      __in          JET_SESID sesid
    );

sesid

The session to use for this call.

This function returns the JET_ERR datatype with one of the following return codes. For more information about the possible ESE errors, see Extensible Storage Engine Errors and Error Handling Parameters.

Return code	Description
JET_errSuccess	The operation completed successfully.
JET_errInstanceUnavailable	It is not possible to complete the operation because the instance associated with the session has encountered a fatal error that requires that access to all data be revoked to protect the integrity of that data. This error will only be returned by Windows XP and later releases.
JET_errNotInitialized	It is not possible to complete the operation because the instance associated with the session has not been initialized yet.
JET_errRestoreInProgress	It is not possible to complete the operation because a restore operation is in progress on the instance associated with the session.
JET_errSessionContextNotSetByThisThread	The session could not be disassociated from the current thread because it is associated with a different thread.
JET_errTermInProgress	It is not possible to complete the operation because the instance associated with the session is being shut down.

On success, the session will be disassociated from the current thread. No change to the database state will occur.

On failure, the session state will remain unchanged. No change to the database state will occur.

JetResetSessionContext must be called on the same thread that called JetSetSessionContext for a given session.

Requirement	Value
Client	Requires Windows Vista, Windows XP, or Windows 2000 Professional.
Server	Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.
Header	Declared in Esent.h.
Library	Use ESENT.lib.
DLL	Requires ESENT.dll.

Feedback