JetOpenDatabase-Funktion

Artikel
06/12/2023

Gilt für: Windows | Windows Server

JetOpenDatabase-Funktion

Die JetOpenDatabase-Funktion öffnet eine zuvor angefügte Datenbank mit den Funktionen JetAttachDatabase oder JetAttachDatabase2 zur Verwendung mit einer Datenbanksitzung. Diese Funktion kann für dieselbe Datenbank mehrmals aufgerufen werden.

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

Parameter

sesid

Der Datenbanksitzungskontext, der für den API-Aufruf verwendet werden soll.

szFilename

Der Name der zu öffnenden Datenbank.

szConnect

Reserviert. Auf NULL festgelegt.

pdbid

Zeiger auf einen Puffer, der bei einem erfolgreichen Aufruf den Bezeichner der Datenbank enthält. Wenn der Aufruf fehlschlägt, ist der Wert nicht definiert.

grbit

Eine Gruppe von Bits, die null oder mehr der folgenden Optionen angeben.

Wert	Bedeutung
JET_bitDbExclusive	Ermöglicht nur das Anfügen einer Datenbank durch eine einzelne Sitzung. Normalerweise können mehrere Sitzungen eine Datenbank öffnen.
JET_bitDbReadOnly	Verhindert Änderungen an der Datenbank.

Rückgabewert

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errDatabaseInUse	Der exklusive Zugriff wurde angefordert, konnte aber nicht gewährt werden.
JET_errDatabaseInvalidPath	In szFilename wurde ein ungültiger Pfad angegeben. szFilename muss ungleich NULL sein und auf eine gültige Datei verweisen.
JET_errDatabaseLocked	Eine andere Sitzung hat die Datenbank bereits exklusiv geöffnet (mit JET_bitDbExclusive).
JET_errDatabaseNotFound	Die Datenbank wurde zuvor nicht angefügt (siehe JetAttachDatabase).
JET_errInvalidDatabase	Es wurde versucht, eine Datei zu öffnen, die keine gültige Datenbankdatei ist.
JET_errOneDatabasePerSession	Es wurde versucht, mehrere Datenbanken zu öffnen, und JET_paramOneDatabasePerSession wurde festgelegt. Weitere Informationen finden Sie unter Systemparameter.
JET_wrnFileOpenReadOnly	Die Datei wurde schreibgeschützt angefügt, aber JetOpenDatabase hat JET_bitDbReadOnly nicht bestanden. Die Datenbank wird weiterhin mit schreibgeschütztem Zugriff geöffnet.

Anforderungen

Anforderung	Wert
Client	Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
Server	Erfordert Windows Server 2008, Windows Server 2003 oder Windows 2000 Server.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.
Unicode	Implementiert als JetOpenDatabaseW (Unicode) und JetOpenDatabaseA (ANSI).

Weitere Informationen

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
Systemparameter

JetOpenDatabase-Funktion