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 JetSetSystemParameter konfiguriert sein. Die Datenbankabsturzwiederherstellung wird automatisch im Rahmen 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 instance, die für diesen Aufruf verwendet werden soll.

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

Bei Windows XP und höheren 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 ein instance unterstützt wird, kann dieser Parameter entweder NULL oder auf einen gültigen Ausgabepuffer festgelegt werden, der NULL oder JET_instanceNil der das globale instance-Handle zurückgibt, das als Nebeneffekt der Initialisierung erstellt wurde. Dieses instance-Handle kann dann an jede andere API übergeben werden, die eine instance. Wenn die Engine im Multi-instance-Modus ausgeführt wird, muss dieser Parameter auf einen gültigen Eingabepuffer festgelegt werden, der das instance Handle enthält, das von der JetCreateInstance zurückgegeben wird, die initialisiert 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 eine Reihe 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 aus, aber halten Sie die Rückgängig-Phase an. Dadurch können zusätzliche Transaktionsprotokolle kopiert und angewendet werden.
JET_bitTruncateLogsAfterRecovery	Kürzen Sie bei erfolgreicher vorläufiger Wiederherstellung Protokolldateien ab.
JET_bitReplayMissingMapEntryDB	Fehlender Datenbankzuordnungseintrag wird standardmäßig am gleichen Speicherort angezeigt.
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 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

Ein instance muss mit einem Aufruf von JetInit2 initialisiert werden, bevor er von einem anderen Element als JetSetSystemParameter verwendet werden kann.

Ein instance wird durch einen Aufruf der JetTerm-Funktion zerstört, auch wenn diese instance nie mit JetInit initialisiert wurde. Ein instance 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 einer Reihe 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

Anforderung	Wert
Client	Erfordert Windows Vista oder Windows XP.
Server	Erfordert Windows Server 2008 oder Windows Server 2003.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

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