JetTerm ist-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

JetTerm ist-Funktion

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

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

JET_ERR JET_API JetTerm(
  __in          JET_INSTANCE instance
);

Parameter

Instance

Gibt die Instanz, die für diesen Aufruf verwendet.

Windows 2000:  Dieser Parameter wird ignoriert und sollte immer NULLsein.

Windows XP und späteren Versionen:  Dieser Parameter ist überlastet. Wenn die Engine im legacy-Modus (Windows 2000-Kompatibilitätsmodus) betrieben wird, in dem nur eine einzige Instanz unterstützt wird, kann dieser Parameter kann NULL sein oder evtl. die aktuelle Instanz, die von JetInitzurückgegeben wird. Wenn das Modul mit mehreren Instanzen wird, muss dieser Parameter einen Zeiger auf eine Instanz sein, die mit JetCreateInstanceerstellt wurde.

Return Value

Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.

Rückgabecode	Beschreibung
JET_errSuccess	Der Vorgang wurde erfolgreich abgeschlossen.
JET_errInvalidParameter	Einer der Parameter, der bereitgestellt wurde einen unerwarteten Wert enthalten oder die Kombination verschiedener Parameter ein unerwartetes Ergebnis zurückgegeben. Dieser Fehler wird durch JetTerm ist zurückgegeben werden, wenn das Modul mit mehreren Instanzen ist und 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, um 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, denn es gibt derzeit Sitzungen mit aktiven Transaktionen für die angegebene Instanz. Dieser Fehler tritt auf, wenn die JET_bitTermComplete verwendet wird.

Wenn diese Funktion erfolgreich ist, wird die angegebene Instanz heruntergefahren. Das Instanzenhandle werden auch geschlossen und an eine beliebige API, die Instanzzugriffsnummer akzeptiert nicht verfügbar gemacht. Alle anderen Objekte, die mit der Instanz, wie Sitzungen werden ebenfalls geschlossen. Der Zustand der Prüfpunktdatei, Transaktionsprotokolldateien und die Datenbankdateien an die Instanz angefügt wird während des Herunterfahrens geändert werden.

Fällt diese Funktion als Ergebnis ein Anwendungsfehler, bleibt die Instanz im initialisierten Zustand, und nichts ändert. Andernfalls wird die Instanz noch nach erfolgreicher Durchführung heruntergefahren. Der Unterschied besteht darin, dass die Instanz benötigen, Wiederherstellung nach einem Absturz durchlaufen, wenn es als Nächstes initialisiert wird. Das Modul versucht, leeren Sie so viele Daten wie möglich, um die Recovery zu minimieren, die erforderlich ist. Ausfall des JetTerm ist ist im Prinzip nichts anderes als ein Prozessabsturz.

Anmerkungen

Wenn der Hostprozess einer Instanz aus irgendeinem Grund beendet, bevor JetTerm ist auf dieser Instanz dann die Instanz angesehen wird in einen abgestürzten Zustand erfolgreich aufgerufen wird. Wiederherstellung nach einem Absturz tritt beim nächsten Versuch, die Instanz zu initialisieren.

Voraussetzungen

-Client,	Erfordert Windows Vista, Windows XP oder Windows 2000 Professional.
Server	Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server.
Kopfzeile	In Esent.h deklariert.
Library	Verwenden Sie ESENT.lib.
DLL	"ESENT.dll" erfordert.

Siehe auch

Extensible Storage Engine-Dateien
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm2