Fonction JetDetachDatabase

S’applique à : Windows | Windows Serveurs

Fonction JetDetachDatabase

La fonction JetDetachDatabase libère un fichier de base de données qui était 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 la 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 est une chaîne vide, toutes les bases de données attachées à sesid seront détachées.

Valeur renvoyée

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 de Stockage Extensible 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 en cours de sauvegarde 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 le détachement.

JET_errDatabaseNotFound

La base de données n’a pas été attachée précédemment (consultez JetAttachDatabase ou JetAttachDatabase2).

JET_errInTransaction

Une tentative de détachement d’une base de données a été effectuée dans une transaction.

Remarques

Si une base de données attachée a été ouverte (avec JetAttachDatabase), elle doit être fermée avec JetCloseDatabase avant le détachement.

Windows 2000 uniquement : les bases de données qui n’ont pas été détachées avant l’appel de JetTerm sont automatiquement rattachées lorsque JetInit est appelé par la suite.

Configuration requise

| | |

Client

|

requiert 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

|

Requiert 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