Funzione JetDetachDatabase

Si applica a: Windows | Windows Server

Funzione JetDetachDatabase

La funzione JetDetachDatabase rilascia un file di database collegato in precedenza a una sessione di database.

    JET_ERR JET_API JetDetachDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename
    );

Parametri

sesid

Contesto della sessione di database da usare per la chiamata API.

szFilename

Nome del database da scollegare. Se szFilename è NULL o una stringa vuota, tutti i database collegati a sesid verranno scollegati.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.

Codice restituito

Descrizione

JET_errSuccess

Operazione riuscita.

JET_errBackupInProgress

Il database viene eseguito il backup e non può essere scollegato.

JET_errDatabaseInUse

Il database è stato aperto da JetOpenDatabase. I database devono essere chiusi prima del scollegamento.

JET_errDatabaseNotFound

Il database non è stato collegato in precedenza (vedere JetAttachDatabase o JetAttachDatabase2).

JET_errInTransaction

È stato effettuato un tentativo di scollegamento di un database durante una transazione.

Commenti

Se è stato aperto un database collegato (con JetAttachDatabase), deve essere chiuso con JetCloseDatabase prima di scollegarsi.

Solo Windows 2000: i database che non sono stati scollegati prima di chiamare JetTerm verranno automaticamente collegati quando JetInit viene chiamato.

Requisiti

Requisito Valore

Client

Richiede Windows Vista, Windows XP o Windows 2000 Professional.

Server

Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Intestazione

Dichiarato in Esent.h.

Libreria

Usare ESENT.lib.

DLL

Richiede ESENT.dll.

Unicode

Implementato come JetDetachDatabaseW (Unicode) e JetDetachDatabaseA (ANSI).

Vedere anche

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm