Функция JetDetachDatabase

  • Статья

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

Функция JetDetachDatabase

Функция JetDetachDatabase освобождает файл базы данных, который ранее был присоединен к сеансу базы данных.

    JET_ERR JET_API JetDetachDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename
    );

Параметры

sesid

Контекст сеанса базы данных, используемый для вызова API.

szFilename

Имя отсоединяемой базы данных. Если szFilename имеет значение NULL или пустую строку, все базы данных, подключенные к sesid , будут отсоединяться.

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

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

Код возврата

Описание

JET_errSuccess

Операция выполнена успешно.

JET_errBackupInProgress

Резервная копия базы данных создается и не может быть отключена.

JET_errDatabaseInUse

База данных была открыта с помощью JetOpenDatabase. Базы данных должны быть закрыты перед отсоединения.

JET_errDatabaseNotFound

База данных ранее не была подключена (см. Раздел JetAttachDatabase или JetAttachDatabase2).

JET_errInTransaction

Предпринята попытка отсоединить базу данных во время транзакции.

Комментарии

Если была открыта подключенная база данных (с помощью JetAttachDatabase), ее необходимо закрыть с помощью JetCloseDatabase перед отсоединением.

Только Windows 2000: базы данных, которые не были отсоединены до вызова JetTerm , будут автоматически повторно подключены при следующем вызове JetInit .

Требования

Требование Значение

Клиент

Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная.

Сервер

Требуется Windows Server 2008, Windows Server 2003 или Windows 2000 Server.

Верхняя часть

Объявлено в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

Юникод

Реализовано как JetDetachDatabaseW (Юникод) и JetDetachDatabaseA (ANSI).

См. также:

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm