Funzione JetOpenDatabase

Si applica a: Windows | Windows Server

Funzione JetOpenDatabase

La funzione JetOpenDatabase apre un database collegato in precedenza, usando le funzioni JetAttachDatabase o JetAttachDatabase2 per l'uso con una sessione di database. Questa funzione può essere chiamata più volte per lo stesso database.

    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
    );

Parametri

sesid

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

szFilename

Nome del database da aprire.

szConnect

Riservato. Impostata su NULL.

pdbid

Puntatore a un buffer che, in una chiamata riuscita, contiene l'identificatore del database. Se la chiamata non riesce, il valore non è definito.

grbit

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

Valore	Significato
JET_bitDbExclusive	Consente solo a una singola sessione di collegare un database. In genere, diverse sessioni possono aprire un database.
JET_bitDbReadOnly	Impedisce modifiche al database.

Valore restituito

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

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errDatabaseInUse	È stato richiesto l'accesso esclusivo, ma non è stato possibile concedere.
JET_errDatabaseInvalidPath	È stato specificato un percorso non valido in szFilename. szFilename deve essere diverso da NULL e fare riferimento a un file valido.
JET_errDatabaseLocked	Un'altra sessione ha già aperto il database in modo esclusivo (tramite JET_bitDbExclusive).
JET_errDatabaseNotFound	Il database non è stato collegato in precedenza (vedere JetAttachDatabase).
JET_errInvalidDatabase	È stato effettuato un tentativo di aprire un file che non è un file di database valido.
JET_errOneDatabasePerSession	È stato effettuato un tentativo di apertura di più database e JET_paramOneDatabasePerSession è stato impostato. Per altre informazioni, vedere Parametri di sistema.
JET_wrnFileOpenReadOnly	Il file è stato allegato come di sola lettura, ma JetOpenDatabase non ha superato JET_bitDbReadOnly. Il database è ancora aperto con accesso di sola lettura.

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 JetOpenDatabaseW (Unicode) e JetOpenDatabaseA (ANSI).

Vedere anche

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
Parametri di sistema