JetAttachDatabase-Funktion

Gilt für: Windows | Windows Server

JetAttachDatabase-Funktion

Die JetAttachDatabase-Funktion fügt eine Datenbankdatei zur Verwendung mit einer Datenbank instance an. Um die Datenbank verwenden zu können, muss sie anschließend mit JetOpenDatabase geöffnet werden.

    JET_ERR JET_API JetAttachDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          JET_GRBIT grbit
    );

Parameter

sesid

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

szFilename

Der Name der anzufügenden Datenbank.

grbit

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

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.

Bemerkungen

Das Aufrufen von JetAttachDatabase entspricht dem Aufrufen von JetAttachDatabase2 und dem Übergeben des Werts 0 (d. h. es gibt keine Beschränkung) für den Parameter cpgDatabaseSizeMax .

Durch das Anfügen einer beschreibbaren Datenbank (d. h. wenn JET_bitDbReadOnly nicht im grbit-Parameter angegeben wurde) wird die Datei ausschließlich auf Betriebssystemebene geöffnet. Kein anderer Prozess kann die Datei öffnen. Es ist möglich, dass mehrere Prozesse eine einzelne Datenbank anfügen, indem sie im schreibgeschützten Modus geöffnet werden.

Die Datenbankdatei wird mithilfe von JetDetachDatabase oder JetDetachDatabase2 getrennt.

Indexüberprüfungsparameter

Verschiedene Versionen von Windows normalisieren Unicode-Text auf unterschiedliche Weise. Das bedeutet, dass Indizes, die unter einer Windows-Version erstellt wurden, unter anderen Versionen möglicherweise nicht funktionieren.

Vor Windows Server 2003, als die Betriebssystemversion geändert wurde (einschließlich der Installation eines Service Packs), befand sich jeder Index über Unicode-Daten in einem potenziell beschädigten Zustand.

In Windows Server 2003 und höher erstellte Indizes werden mit der Version der Unicode-Normalisierung gekennzeichnet, mit der sie erstellt wurden. Ältere Indizes enthalten keine Versionsinformationen. Die meisten Unicode-Normalisierungsänderungen bestehen aus dem Hinzufügen neuer Zeichen. Codepunkte, die zuvor nicht definiert waren, werden jetzt definiert und normalisiert sich anders. Wenn binäre Daten also in einer Unicode-Spalte gespeichert werden, normalisieren sie sich anders, wenn neue Codepunkte definiert werden.

Ab Windows Server 2003 verfolgt die ESE-Datenbank-Engine Unicode-Indexeinträge nach, die nicht definierte Codepunkte enthalten. Diese können verwendet werden, um einen Index zu korrigieren, wenn sich der Satz von definierten Unicode-Zeichen ändert.

Diese Parameter steuern, was geschieht, wenn die ESE-Datenbank-Engine an eine Datenbank anfügt, die zuletzt unter einem anderen Build des Betriebssystems verwendet wurde. Die Betriebssystemversion wird im Datenbankheader gestempelt.

Wenn JET_paramEnableIndexChecking auf TRUE festgelegt ist und die Datenbank potenziell beschädigte Indizes enthält:

• JetAttachDatabase löscht die potenziell beschädigten Indizes, wenn grbit JET_bitDbDeleteCorruptIndexes

• JetAttachDatabasegibt einen Fehler zurück, wenn grbit keine JET_bitDbDeleteCorruptIndexes enthält und Indizes vorhanden sind, die gelöscht werden müssen.

Wenn JET_paramEnableIndexChecking auf FALSE festgelegt ist:

• JetAttachDatabase ignoriert potenziell beschädigte Indizes und gibt JET_errSuccess zurück (sofern keine anderen Fehler aufgetreten sind).

Windows Server 2003 und höher: Wenn JET_paramEnableIndexChecking nicht zurückgesetzt wurde, wird die interne Fixuptabelle verwendet, um Indexeinträge zu korrigieren. Dies kann nicht alle Indexbeschädigungen beheben, ist aber für die Anwendung transparent.

Wenn die Datenbank schreibgeschützt angefügt wurde, kann der Index nicht korrigiert oder gelöscht werden. In diesem Fall gibt die API stattdessen einen Fehler zurück, z. B. JET_errSecondaryIndexCorrupted oder JET_errPrimaryIndexCorrupted.

Anforderungen

Weitere Informationen

Erweiterbare Speichermoduldateien
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase2
JetCreateDatabase
JetDetachDatabase
JetDetachDatabase2
JetOpenDatabase
JetSetSystemParameter