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