Fonction JetDetachDatabase
S’applique à : Windows | serveur Windows
Fonction JetDetachDatabase
La fonction JetDetachDatabase libère un fichier de base de données précédemment attaché à une session de base de données.
JET_ERR JET_API JetDetachDatabase(
__in JET_SESID sesid,
__in const tchar* szFilename
);
Paramètres
sesid
Contexte de session de base de données à utiliser pour l’appel d’API.
szFilename
Nom de la base de données à détacher. Si szFilename a la valeur NULL ou une chaîne vide, toutes les bases de données attachées à sesid sont détachées.
Valeur de retour
Cette fonction retourne le type de données JET_ERR avec l’un des codes de retour suivants. Pour plus d’informations sur les erreurs ESE possibles, consultez Erreurs du moteur extensible Stockage et paramètres de gestion des erreurs.
Code de retour |
Description |
---|---|
JET_errSuccess |
L’opération s’est terminée avec succès. |
JET_errBackupInProgress |
La base de données est sauvegardée et ne peut pas être détachée. |
JET_errDatabaseInUse |
La base de données a été ouverte par JetOpenDatabase. Les bases de données doivent être fermées avant de se détacher. |
JET_errDatabaseNotFound |
La base de données n’a pas été attachée précédemment (voir JetAttachDatabase ou JetAttachDatabase2). |
JET_errInTransaction |
Une tentative a été effectuée pour détacher une base de données pendant une transaction. |
Notes
Si une base de données jointe a été ouverte (avec JetAttachDatabase), elle doit être fermée avec JetCloseDatabase avant de se détacher.
Windows 2000 uniquement : les bases de données qui n’ont pas été détachées avant d’appeler JetTerm sont automatiquement attachées lorsque JetInit est appelé ensuite.
Spécifications
Condition requise | Valeur |
---|---|
Client |
Nécessite Windows Vista, Windows XP ou Windows 2000 Professional. |
Serveur |
Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server. |
En-tête |
Déclaré dans Esent.h. |
Bibliothèque |
Utilisez ESENT.lib. |
DLL |
Nécessite ESENT.dll. |
Unicode |
Implémenté en tant que JetDetachDatabaseW (Unicode) et JetDetachDatabaseA (ANSI). |
Voir aussi
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm