JetDetachDatabase-Funktion

  • Artikel

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 szFilenameNULL oder eine leere Zeichenfolge ist, werden alle datenbanken, die an sesid angefügt sind, getrennt.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errBackupInProgress

Die Datenbank wird gesichert 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 wurde zuvor nicht angefügt (siehe JetAttachDatabase oder JetAttachDatabase2).

JET_errInTransaction

Es wurde versucht, eine Datenbank in einer Transaktion zu trennen.

Bemerkungen

Wenn eine angefügte Datenbank geöffnet wurde (mit JetAttachDatabase), muss sie vor dem Trennen mit JetCloseDatabase geschlossen werden.

Nur Windows 2000: Datenbanken, die vor dem Aufrufen von JetTerm nicht getrennt wurden, werden automatisch erneut angefügt, wenn JetInit als nächstes aufgerufen wird.

Anforderungen

Anforderung Wert

Client

Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.

Server

Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.

Kopfzeile

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Unicode

Implementiert als JetDetachDatabaseW (Unicode) und JetDetachDatabaseA (ANSI).

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm