JetTerm-Funktion

Gilt für: Windows | Windows Server

JetTerm-Funktion

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

JetTerm kann auch verwendet werden, um eine nicht initialisierte Instanz zu zerstören, die von JetCreateInstanceerstellt wurde.

    JET_ERR JET_API JetTerm(
      __in          JET_INSTANCE instance
    );

Parameter

Instanz

Gibt die -Instanz an, 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.

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.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

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_errBackupInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Sicherungsvorgang 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 gemäß dem Erfolgsfall 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

Wenn der Hostprozess einer Instanz aus irgendeinem Grund beendet wird, bevor JetTerm für diese Instanz erfolgreich aufgerufen wird, wird die Instanz als abgestürzt betrachtet. Die Absturzwiederherstellung erfolgt beim nächsten Versuch, diese Instanz zu initialisieren.

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
JetTerm2