JetTerm2-Funktion

Gilt für: Windows | Windows Server

JetTerm2-Funktion

Die JetTerm2-Funktion initiiert das Herunterfahren einer Instanz, die von JetInitinitialisiert wurde.

JetTerm2 kann auch eine nicht initialisierte Instanz zerstören, die von JetCreateInstanceerstellt wurde.

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

Parameter

Instanz

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

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

Windows XP und höher: Dieser Parameter ist überladen. Wenn die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) ausgeführt wird, in dem nur eine Instanz unterstützt wird, kann dieser Parameter NULL sein oder die tatsächliche Instanz enthalten, die von JetInitzurückgegeben wird. Wenn die Engine im Modus mit mehreren Instanzen ausgeführt wird, muss dieser Parameter ein Zeiger auf eine Instanz sein, die mit JetCreateInstanceerstellt 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 Instanz sauber heruntergefahren wird. Alle optionalen Bereinigungsarbeiten, die normalerweise zur Laufzeit im Hintergrund ausgeführt werden, werden sofort abgeschlossen.

JET_bitTermAbrupt

Fordert an, dass die Instanz so schnell wie möglich heruntergefahren wird. Alle optionalen Arbeiten, die normalerweise zur Laufzeit im Hintergrund ausgeführt werden, werden abgebrochen.

Hinweis Diese Option kann zu temporärem oder dauerhaftem Speicherplatzverlust in der Datenbank führen. Dieser verlorene Speicherplatz kann immer durch eine Offlinedefragmentierung der Datenbank wiederhergestellt werden.

JET_bitTermStopBackup

Fordert an, dass die Instanz heruntergefahren wird, 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 Instanz mit allen angefügten Datenbanken heruntergefahren wird, die sich in einem geänderten Zustand befinden.

Windows 7: JET_bitTermDirty 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 möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errBackupInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Sicherungsvorgang für die Instanz 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 Modus mit mehreren Instanzen befindet und wenn pinstance auf eine ungültige Instanz verweist.

Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.

JET_errNotInitialized

Der Vorgang kann nicht abgeschlossen werden, da die Instanz noch nicht initialisiert wurde.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da die Instanz heruntergefahren wird.

JET_errRestoreInProgress

Es ist nicht möglich, den Vorgang abzuschließen, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird.

JET_errTooManyActiveUsers

Die Instanz kann nicht heruntergefahren werden, da derzeit Sitzungen mit aktiven Transaktionen für die angegebene Instanz vorhanden sind. Dieser Fehler tritt nur auf, wenn die JET_bitTermComplete verwendet wird.

Wenn diese Funktion erfolgreich ausgeführt wird, wird die angegebene Instanz heruntergefahren. Das Instanzhandle wird ebenfalls geschlossen und für alle APIs, die ein Instanzhandle verwenden, nicht verfügbar gemacht. Alle anderen Objekte, die der Instanz zugeordnet sind, z. B. Sitzungen, werden ebenfalls geschlossen. Der Status der Prüfpunktdatei, der Transaktionsprotokolldateien und der Datenbankdateien, die an die Instanz angefügt sind, wird während des Herunterfahrens geändert.

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

Bemerkungen

Weitere Informationen finden Sie unter JetTerm.

Requirements (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.

Header

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

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