JetDetachDatabase2-Funktion

Gilt für: Windows | Windows Server

JetDetachDatabase2-Funktion

Die JetDetachDatabase2-Funktion gibt eine Datenbankdatei frei, die zuvor an eine Datenbanksitzung angefügt wurde.

**Windows XP:**JetDetachDatabase2 wird in Windows XP eingeführt.

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

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.

grbit

Eine Gruppe von Bits, die null oder mehr der folgenden Optionen an geben.

Wert

Bedeutung

JET_bitForceCloseAndDetach

Erzwingt, dass die Datenbank geschlossen und getrennt wird. Wenn JET_bitForceCloseAndDetach nicht unterstützt wird, JET_errForceDetachNotAllowed zurückgegeben.

JET_bitForceDetach

Erzwingt, dass die Datenbank getrennt wird. Wenn JET_bitForceDetach nicht unterstützt wird, JET_errForceDetachNotAllowed zurückgegeben.

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_errForceDetachNotAllowed

JET_bitForceDetach wird nicht unterstützt.

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 nur 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 oder Windows XP.

| |

Server

|

Erfordert Windows Server 2008 oder Windows Server 2003.

| |

Header

|

Wird in Esent.h deklariert.

| |

Bibliothek

|

Verwenden Sie ESENT.lib.

| |

DLL

|

Erfordert ESENT.dll.

| |

Unicode

|

Wird als JetDetachDatabase2W (Unicode) und JetDetachDatabase2A (ANSI) implementiert.

|

Weitere Informationen

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