Windows Dev Center

Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original

JetTerm ist-Funktion

Letzte Änderung: Freitag, 27. Februar 2015

Gilt für: Windows | Windows Server

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

Anzeigen:
© 2015 Microsoft