Fonction JetOpenDatabase

Article
06/12/2023

S’applique à : Windows | Windows Server

Fonction JetOpenDatabase

La fonction JetOpenDatabase ouvre une base de données précédemment attachée, à l’aide des fonctions JetAttachDatabase ou JetAttachDatabase2 , à utiliser avec une session de base de données. Cette fonction peut être appelée plusieurs fois pour la même base de données.

    JET_ERR JET_API JetOpenDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in_opt      const tchar* szConnect,
      __out         JET_DBID* pdbid,
      __in          JET_GRBIT grbit
    );

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 à ouvrir.

szConnect

Réservé. valeur de l’en-tête définie sur Null.

pdbid

Pointeur vers une mémoire tampon qui, lors d’un appel réussi, contient l’identificateur de la base de données. Si l’appel échoue, la valeur n’est pas définie.

grbit

Groupe de bits qui spécifient zéro ou plusieurs des options suivantes.

Valeur	Signification
JET_bitDbExclusive	Permet à une seule session d’attacher une base de données. Normalement, plusieurs sessions peuvent ouvrir une base de données.
JET_bitDbReadOnly	Empêche les modifications apportées à la base de donné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_errDatabaseInUse	L’accès exclusif a été demandé, mais n’a pas pu être accordé.
JET_errDatabaseInvalidPath	Un chemin d’accès non valide a été indiqué dans szFilename. szFilename doit être non NULL et faire référence à un fichier valide.
JET_errDatabaseLocked	Une autre session a déjà ouvert la base de données exclusivement (à l’aide de JET_bitDbExclusive).
JET_errDatabaseNotFound	La base de données n’a pas été précédemment attachée (voir JetAttachDatabase).
JET_errInvalidDatabase	Une tentative a été effectuée pour ouvrir un fichier qui n’est pas un fichier de base de données valide.
JET_errOneDatabasePerSession	Une tentative a été effectuée pour ouvrir plusieurs bases de données et JET_paramOneDatabasePerSession a été définie. Pour plus d’informations, consultez Paramètres système.
JET_wrnFileOpenReadOnly	Le fichier a été joint en lecture seule, mais JetOpenDatabase n’a pas réussi JET_bitDbReadOnly. La base de données est toujours ouverte avec accès en lecture seule.

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.
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 JetOpenDatabaseW (Unicode) et JetOpenDatabaseA (ANSI).

Voir aussi

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
Paramètres système

Fonction JetOpenDatabase