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 Professional。 |
Server |
需要 Windows Server 2008、Windows Server 2003 或 Windows 2000 Server。 |
標頭 |
在 Esent.h 中宣告。 |
程式庫 |
使用 ESENT.lib。 |
Dll |
需要ESENT.dll。 |
Unicode |
實作為 JetDetachDatabaseW (Unicode) 和 JetDetachDatabaseA (ANSI) 。 |
另請參閱
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm