JetAttachDatabase-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetAttachDatabase-Funktion

Die Funktion JetAttachDatabase fügt eine Datenbankdatei für die Verwendung mit einer Datenbankinstanz. Um die Datenbank verwenden, müssen sie anschließend mit JetOpenDatabasegeöffnet werden.

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

Parameter

sesid

Der Kontext, für den API-Aufruf zu verwendenden Datenbank Sitzung.

szFilename

Der Name der Datenbank anfügen.

JET_errInvalidGrbit

Eine Gruppe von Bits an, die NULL oder mehrere der folgenden Optionen angeben.

Return Value

Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.

Anmerkungen

Das Aufrufen JetAttachDatabase entspricht dem Aufrufen der JetAttachDatabase2 und dem Wert 0 (null), was bedeutet, dass es gibt keine Beschränkung, für den CpgDatabaseSizeMax -Parameter übergeben.

Anfügen einer Datenbank schreibgeschützt (d. h., wenn JET_bitDbReadOnly im JET_errInvalidGrbit -Parameter nicht angegeben wurde), öffnen Sie die Datei exklusiv auf Betriebssystemebene. Kein anderer Prozess werden die Lage, öffnen Sie die Datei. Es ist möglich, dass mehrere Prozesse zum Anfügen einer einzelnen Datenbank im schreibgeschützten Modus geöffnet werden.

Die Datenbankdatei ist unter Verwendung JetDetachDatabase ist oder JetDetachDatabase2getrennt.

Überprüfung der Index Parameter

Verschiedene Versionen von Windows normalisieren Unicode-Text auf unterschiedliche Weise. Dass bedeutet, dass Indizes in einer Version von Windows erstellt funktioniert nicht auf andere Versionen.

Vor Windows Server 2003 wurde bei der Version des Betriebssystems geändert (einschließlich der Installation von Service Pack) jeder Index über Unicode-Daten möglicherweise beschädigt.

In Windows Server 2003 und höher erstellte Indizes werden mit der Version von Unicode-Normalisierung gekennzeichnet, mit denen sie erstellt wurden. Ältere Indizes enthalten keine Versionsinformationen. Die meisten Unicode-Normalisierung Änderungen des Hinzufügens von neuer Zeichen bestehen, Codepunkte, die zuvor nicht definierten Waren werden nun definiert und Normalisieren unterschiedlich. Folglich Wenn binäre Daten in einer Spalte Unicode gespeichert ist, wird es unterschiedlich normalisieren neuen Codepunkte definiert sind.

Im Windows Server 2003 verfolgt die ESE-Datenbank-Engine Unicode Indexeinträge, die nicht definiert Code Punkt enthalten. Diese können verwendet werden, um einen Index zu beheben, wenn der Satz von definierten Unicode Änderungen Zeichen.

Diese Parameter steuern, was geschieht, wenn der ESE-Datenbank-Engine an eine Datenbank angefügt wird, die unter einem anderen Build des Betriebssystems zuletzt verwendet wurde. Version des Betriebssystems ist in der Datenbank-Kopfzeile enthalten.

Wenn JET_paramEnableIndexChecking auf TRUEfestgelegt ist, und die Datenbank möglicherweise beschädigt Indizes enthält:

• JetAttachDatabase löscht die Indizes möglicherweise beschädigt, wenn JET_errInvalidGrbit JET_bitDbDeleteCorruptIndexes enthält

• JetAttachDatabasegibt einen Fehler zurück, wenn JET_errInvalidGrbit enthält keine JET_bitDbDeleteCorruptIndexes und Indizes, die Löschung erforderlich sind.

Wenn JET_paramEnableIndexChecking auf FALSEfestgelegt ist:

• JetAttachDatabase potenziell beschädigte Indizes ignoriert und JET_errSuccess (vorausgesetzt, dass keine anderen Fehler) zurückzugeben.

WindowsServer 2003 und höher: Wenn JET_paramEnableIndexChecking nicht zurückgesetzt wurde, werden die internen Fixup-Tabelle für Indexeinträge Fixup verwendet. Dies kann möglicherweise nicht alle Beschädigungen des Index beheben ist jedoch für die Anwendung transparent.

Wenn die Datenbank, als schreibgeschützt angefügt wurde werden nicht der Index mit fester oder gelöscht. In diesem Fall wird die API stattdessen einen Fehler, wie JET_errPrimaryIndexCorrupted oder JET_errPrimaryIndexCorrupted zurück.

Voraussetzungen

Siehe auch

Extensible Storage Engine Dateien
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase2
JetCreateDatabase
JetDetachDatabase ist
JetDetachDatabase2
JetOpenDatabase
JetSetSystemParameter