Поделиться через

Функция JetEndSession

  • Статья

Применимо к: 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