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


Функция JetDetachDatabase2

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

Функция JetDetachDatabase2

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

Windows XP:JetDetachDatabase2 представлена в Windows XP.

    JET_ERR JET_API JetDetachDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          JET_GRBIT grbit
    );

Параметры

sesid

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

szFilename

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

grbit

Группа битов, задающая ноль или несколько следующих параметров.

Значение

Значение

JET_bitForceCloseAndDetach

Принудительно закрывает и отсоединяет базу данных. Если JET_bitForceCloseAndDetach не поддерживается, возвращается JET_errForceDetachNotAllowed.

JET_bitForceDetach

Принудительно отсоединяет базу данных. Если JET_bitForceDetach не поддерживается, возвращается JET_errForceDetachNotAllowed.

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

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

Код возврата

Описание

JET_errSuccess

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

JET_errBackupInProgress

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

JET_errDatabaseInUse

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

JET_errDatabaseNotFound

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

JET_errForceDetachNotAllowed

JET_bitForceDetach не поддерживается.

JET_errInTransaction

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

Комментарии

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

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

Требования

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

Клиент

Требуется Windows Vista или Windows XP.

Сервер

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

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

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

Библиотека

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

DLL

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

Юникод

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

См. также:

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCloseDatabase
JetCreateDatabase
JetCreateDatabase2
JetInit
JetOpenDatabase
JetTerm