JetInit2-Funktion

Gilt für: Windows | Windows Server

JetInit2-Funktion

Die JetInit2-Funktion versetzt die Datenbank-Engine in einen Zustand, in dem sie die Anwendungsverwendung von Datenbankdateien unterstützen kann. Die Engine muss bereits ordnungsgemäß für die Initialisierung mit JetSetSystemParameterkonfiguriert sein. Die Datenbankabsturzwiederherstellung wird automatisch als Teil des Initialisierungsprozesses ausgeführt.

**Windows XP:**JetInit2 wird in Windows XP eingeführt.

Diese Funktion ist veraltet. Verwenden Sie stattdessen JetInit3.

JET_ERR JET_API JetInit2(
  __in_out_opt  JET_INSTANCE* pinstance,
  __in          JET_GRBIT grbit
);

Parameter

Pinstance

Die -Instanz, die für diesen Aufruf verwendet werden soll.

Für Windows 2000 wird dieser Parameter ignoriert und sollte immer NULL sein.

Für Windows XP und höhere Versionen hängt die Verwendung dieses Parameters vom Betriebsmodus der Engine ab. Wenn die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) ausgeführt wird, in dem nur eine Instanz unterstützt wird, kann dieser Parameter entweder NULL sein oder auf einen gültigen Ausgabepuffer mit NULL oder JET_instanceNil festgelegt werden, der das globale Instanzhandle zurückgibt, das als Nebeneffekt der Initialisierung erstellt wurde. Dieses Instanzhandle kann dann an jede andere API übergeben werden, die eine -Instanz annimmt. Wenn die Engine im Modus mit mehreren Instanzen ausgeführt wird, muss dieser Parameter auf einen gültigen Eingabepuffer festgelegt werden, der das Instanzhandle enthält, das von der initialisierten JetCreateInstance zurückgegeben wird.

grbit

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

Wert

Bedeutung

JET_bitReplayReplicatedLogFiles

Für die zukünftige Verwendung reserviert.

JET_bitCreateSFSVolumeIfNotExist

Für die zukünftige Verwendung reserviert.

JET_bitReplayIgnoreMissingDB

Mit dieser Option kann der Benutzer die Wiederherstellung für einen Satz von Protokolldateien ausführen, ohne dass alle Datenbanken vorhanden sind, die an einem Punkt des Protokollsatzes angefügt wurden.

JET_bitRecoveryWithoutUndo

Führen Sie die Wiederherstellung durch, aber halten Sie in der Rückgängig-Phase an. Dadurch können zusätzliche Transaktionsprotokolle kopiert und angewendet werden.

JET_bitTruncateLogsAfterRecovery

Kürzen Sie protokolldateien bei erfolgreicher soft recovery ab.

JET_bitReplayMissingMapEntryDB

Fehlender Datenbankzuordnungseintrag wird standardmäßig an demselben Speicherort verwendet.

JET_bitReplayIgnoreLostLogs

Ignorieren Sie Protokolle, die am Ende des Protokolldatenstroms verloren gegangen sind.

Windows 7:JET_bitReplayIgnoreLostLogs wird in Windows 7 eingeführt.

Rückgabewert

Diese Funktion gibt den JET_ERR Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Hinweise

Eine -Instanz muss mit einem Aufruf von JetInit2 initialisiert werden, bevor sie von anderen Instanzen als JetSetSystemParameterverwendet werden kann.

Eine -Instanz wird durch einen Aufruf der JetTerm-Funktion zerstört, auch wenn diese Instanz nie mit JetInitinitialisiert wurde. Eine -Instanz ist die Einheit der Wiederherstellbarkeit für die Datenbank-Engine. Sie steuert den Lebenszyklus aller Dateien, die zum Schutz der Integrität der Daten in einem Satz von Datenbankdateien verwendet werden. Zu diesen Dateien gehören die Prüfpunktdatei und die Transaktionsprotokolldateien.

Wenn die Wiederherstellung für eine Reihe von Protokollen ausgeführt wird, für die nicht alle Datenbanken vorhanden sind (wodurch der Fehler unter normalen Umständen JET_errAttachedDatabaseMismatch zurückgegeben wird) und der Client die Wiederherstellung trotz fehlender Datenbanken fortsetzen möchte, wird die JET_ bitReplayIgnoreMissingDB verwendet, um die Wiederherstellung für die verfügbaren Datenbanken fortzusetzen.

Weitere Informationen finden Sie im Abschnitt "Hinweise" in JetInit.

Anforderungen

| | |

Client

|

Erfordert Windows Vista oder Windows XP.

| |

Server

|

Erfordert Windows Server 2008 oder Windows Server 2003.

| |

Header

|

Deklariert in Esent.h.

| |

Bibliothek

|

Verwenden Sie ESENT.lib.

| |

DLL

|

Erfordert ESENT.dll.

|

Weitere Informationen

Erweiterbare Storage-Engine-Dateien
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
Ressourcenparameter