Функция 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