JetDetachDatabase-Funktion
Gilt für: Windows | Windows Server
JetDetachDatabase-Funktion
Die JetDetachDatabase-Funktion gibt eine Datenbankdatei frei, die zuvor an eine Datenbanksitzung angefügt wurde.
JET_ERR JET_API JetDetachDatabase(
__in JET_SESID sesid,
__in const tchar* szFilename
);
Parameter
sesid
Der Datenbanksitzungskontext, der für den API-Aufruf verwendet werden soll.
szFilename
Der Name der zu trennenden Datenbank. Wenn szFilename NULL oder eine leere Zeichenfolge ist, werden alle datenbanken, die an sesid angefügt sind, getrennt.
Rückgabewert
Diese Funktion gibt den JET_ERR datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errBackupInProgress |
Die Datenbank wird sichern und kann nicht getrennt werden. |
JET_errDatabaseInUse |
Die Datenbank wurde von JetOpenDatabase geöffnet. Datenbanken müssen vor dem Trennen geschlossen werden. |
JET_errDatabaseNotFound |
Die Datenbank war zuvor nicht angefügt (siehe JetAttachDatabase oder JetAttachDatabase2). |
JET_errInTransaction |
Es wurde versucht, eine Datenbank während einer Transaktion zu trennen. |
Hinweise
Wenn eine angefügte Datenbank geöffnet wurde (mit JetAttachDatabase), muss sie vor dem Trennen mit JetCloseDatabase geschlossen werden.
Windows 2000: Datenbanken, die vor dem Aufrufen von JetTerm nicht getrennt wurden, werden automatisch erneut angefügt, wenn JetInit das nächste Mal aufgerufen wird.
Anforderungen
| | |
Client
|Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
| |Server
|Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.
| |Header
|Wird in Esent.h deklariert.
| |Bibliothek
|Verwenden Sie ESENT.lib.
| |DLL
|Erfordert ESENT.dll.
| |Unicode
|Wird als JetDetachDatabaseW (Unicode) und JetDetachDatabaseA (ANSI) implementiert.
|Weitere Informationen
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm