JetTerm2-Funktion

Gilt für: Windows | Windows Server

JetTerm2-Funktion

Die JetTerm2-Funktion initiiert das Herunterfahren einer instance, die von JetInit initialisiert wurde.

JetTerm2 kann auch eine nicht initialisierte instance zerstören, die von JetCreateInstance erstellt wurde.

    JET_ERR JET_API JetTerm2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Parameter

instance

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

Windows 2000: Dieser Parameter wird ignoriert und sollte immer NULL sein.

Windows XP und höhere Versionen: Dieser Parameter ist überladen. Wenn die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) ausgeführt wird, in dem nur ein instance unterstützt wird, kann dieser Parameter NULL sein oder die tatsächliche instance enthalten, die von JetInit zurückgegeben wird. Wenn die Engine im Multi-instance-Modus ausgeführt wird, muss dieser Parameter ein Zeiger auf eine instance sein, die mit JetCreateInstance erstellt wurde.

grbit

Eine Gruppe von Bits, die die Für diesen Aufruf zu verwendenden Optionen enthalten, die null oder mehr der folgenden Werte enthalten.

Wert	Bedeutung
JET_bitTermComplete	Fordert an, dass die instance ordnungsgemäß heruntergefahren werden. Alle optionalen Bereinigungsarbeiten, die normalerweise zur Laufzeit im Hintergrund ausgeführt werden, werden sofort abgeschlossen.
JET_bitTermAbrupt	Fordert an, dass die instance so schnell wie möglich heruntergefahren werden. Alle optionalen Arbeiten, die normalerweise zur Laufzeit im Hintergrund ausgeführt würden, werden abgebrochen. Hinweis Diese Option kann zu einem temporären oder dauerhaften Speicherplatzverlust in der Datenbank führen. Dieser verlorene Speicherplatz kann immer durch eine Offline-Defragmentierung der Datenbank wiederhergestellt werden.
JET_bitTermStopBackup	Fordert an, dass die instance heruntergefahren werden, auch wenn derzeit eine Sicherung ausgeführt wird. Normalerweise würde eine ausstehende Sicherung dazu führen, dass JetTerm mit JET_errBackupInProgress fehlschlägt. Wenn dieser Parameter nicht vorhanden ist, wird davon ausgegangen, dass sein Wert JET_bitTermAbrupt ist.
JET_bitTermDirty	Fordert an, dass die instance heruntergefahren werden, wobei alle angefügten Datenbanken in einem modifiziert Zustand verbleiben. Windows 7: JET_bitTermDirty 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.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errBackupInProgress	Der Vorgang kann nicht abgeschlossen werden, da auf der instance ein Sicherungsvorgang ausgeführt wird.
JET_errInvalidParameter	Einer der bereitgestellten Parameter enthielt einen unerwarteten Wert, oder die Kombination mehrerer Parameter führte zu einem unerwarteten Ergebnis. Dieser Fehler wird von JetTerm zurückgegeben, wenn sich die Engine im Multi-instance-Modus befindet und wenn sich die Pinstance auf eine ungültige instance bezieht. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.
JET_errNotInitialized	Der Vorgang kann nicht abgeschlossen werden, da die instance noch nicht initialisiert wurde.
JET_errTermInProgress	Der Vorgang kann nicht abgeschlossen werden, da die instance heruntergefahren wird.
JET_errRestoreInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da auf der instance ein Wiederherstellungsvorgang ausgeführt wird.
JET_errTooManyActiveUsers	Die instance kann nicht heruntergefahren werden, da derzeit Sitzungen mit aktiven Transaktionen für die angegebene instance vorhanden sind. Dieser Fehler tritt nur auf, wenn die JET_bitTermComplete verwendet wird.

Wenn diese Funktion erfolgreich ist, wird die angegebene instance heruntergefahren. Das instance-Handle wird ebenfalls geschlossen und für jede API, die ein instance Handle verwendet, nicht verfügbar gemacht. Alle anderen Objekte, die dem instance zugeordnet sind, z. B. Sitzungen, werden ebenfalls geschlossen. Der Status der Prüfpunktdatei, der Transaktionsprotokolldateien und der an die instance angefügten Datenbankdateien wird während des Herunterfahrens geändert.

Wenn diese Funktion aufgrund eines Verwendungsfehlers fehlschlägt, verbleibt die instance in einem initialisierten Zustand, und es ändert sich nichts. Andernfalls wird die instance wie für den Erfolgsfall angegeben weiterhin heruntergefahren. Der Unterschied besteht darin, dass die instance bei der nächsten Initialisierung eine Absturzwiederherstellung durchlaufen muss. Die Engine versucht, so viele Daten wie möglich zu leeren, um den erforderlichen Wiederherstellungsaufwand zu minimieren. Konzeptionell unterscheidet sich ein solcher JetTerm-Ausfall nicht von einem Prozessabsturz.

Bemerkungen

Siehe JetTerm.

Anforderungen

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

Weitere Informationen

Erweiterbare Speicher-Engine-Dateien
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm