Функция JetEndSession

Статья
06/13/2023

Применимо к: Windows | Windows Server

Функция JetEndSession

Функция JetEndSession завершает сеанс, очищает и освобождает все ресурсы, связанные с указанным сеансом.

    JET_ERR JET_API JetEndSession(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

Параметры

sesid

Сеанс, который необходимо завершить. Связанные ресурсы освобождаются по завершении сеанса.

grbit

Зарезервировано. Этот параметр может содержать флаг JET_bitForceSessionClosed, но этот флаг зарезервирован и его установка не оказывает влияния.

Возвращаемое значение

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделах Ошибки подсистемы расширяемого хранилища и Параметры обработки ошибок.

Код возврата	Описание
JET_errSuccess	Операция выполнена успешно.
JET_errClientRequestToStopJetService	Невозможно выполнить операцию, так как все действия экземпляра, связанного с сеансом, прекратились в результате вызова JetStopService.
JET_errInvalidParameter	Один из предоставленных параметров содержал непредвиденное значение или сочетание нескольких значений параметров привело к непредвиденному результату.
JET_errInvalidSesid	Сеанс не был допустимым сеансом JET.
JET_errNotInitialized	Невозможно выполнить операцию, так как экземпляр, связанный с сеансом, еще не инициализирован.
JET_errOutOfMemory	Операция завершилась сбоем, так как не удалось выделить память.
JET_errSessionInUse	Это означает, что сеанс использовался в другом потоке или сеанс не был настроен или сброшен должным образом.
JET_errInstanceUnavailable	Невозможно выполнить операцию, так как экземпляр, связанный с сеансом, столкнулся с неустранимой ошибкой, требующей отмены доступа ко всем данным для защиты целостности этих данных. Эта ошибка будет возвращена только в Windows XP и более поздних выпусках.
JET_errOutOfBuffers	Системная ошибка, указывающая на отсутствие буферов.
JET_errRestoreInProgress	Невозможно выполнить операцию, так как операция восстановления выполняется в экземпляре, связанном с сеансом.
JET_errTermInProgress	Невозможно выполнить операцию, так как экземпляр, связанный с сеансом, завершает работу.

При успешном выполнении дескриптор сеанса закрывается и становится недоступным, а все ресурсы, связанные с этим сеансом, очищаются.

При сбое возникает несколько дополнительных ошибок, которые могут возникнуть при закрытии таблицы сортировки, закрытии курсора и откате транзакций. Эти ошибки довольно маловероятны и крайне маловероятны, если сеансы не используются полностью при вызове JetEndSession . Эти ошибки будут возвращены, если не удалось правильно очистить часть сеанса.

Этот API откатит все открытые транзакции (не зафиксированные на уровне 0). Кроме того, будут очищены все курсоры, связанные с этим сеансом, и все созданные или открытые таблицы сортировки.

Требования

Требование	Значение
Клиент	Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная.
Сервер	Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.
Верхняя часть	Объявлено в Esent.h.
Библиотека	Используйте ESENT.lib.
DLL	Требуется ESENT.dll.

См. также:

JET_GRBIT
JET_SESID
JetBeginSession
JetRollback
JetSetSystemParameter
JetStopService

Функция JetEndSession