Funzione JetDetachDatabase2

Si applica a: Windows | Windows Server

Funzione JetDetachDatabase2

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

Windows XP:JetDetachDatabase2 viene introdotto in Windows XP.

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

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.

grbit

Un gruppo di bit che specificano zero o più delle opzioni seguenti.

Valore	Significato
JET_bitForceCloseAndDetach	Forza la chiusura e il scollegamento del database. Se JET_bitForceCloseAndDetach non è supportato, verrà restituito JET_errForceDetachNotAllowed.
JET_bitForceDetach	Forza il disconnessione del database. Se JET_bitForceDetach non è supportato, verrà restituito JET_errForceDetachNotAllowed.

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_errForceDetachNotAllowed	JET_bitForceDetach non è supportato.
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 o Windows XP.
Server	Richiede Windows Server 2008 o Windows Server 2003.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.
Unicode	Implementato come JetDetachDatabase2W (Unicode) e JetDetachDatabase2A (ANSI).

Vedere anche

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