JetTerm2-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetTerm2-Funktion
Die JetTerm2 -Funktion initiiert das Beenden einer Instanz, die von JetInitinitialisiert wurde.
JetTerm2 können auch eine nicht initialisierte Instanz zerstört, die von JetCreateInstanceerstellt wurde.
JET_ERR JET_API JetTerm2(
__in JET_INSTANCE instance,
__in JET_GRBIT grbit
);
Parameter
Instance
Die Instanz, die für diesen Aufruf verwenden.
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.
JET_errInvalidGrbit
Eine Gruppe von Bits, die die Optionen für diesen Aufruf enthalten, die keine oder mehrere der folgenden Werte enthalten.
Wert |
Bedeutung |
---|---|
JET_bitTermComplete |
Anforderungen, die die Instanz ordnungsgemäß heruntergefahren werden. Alle optionalen Bereinigungen, die normalerweise im Hintergrund würde, zur Laufzeit ausgeführt werden erfolgt sofort. |
JET_bitTermAbrupt |
Anforderungen, die die Instanz so schnell wie möglich geschlossen werden. Optionale arbeiten, die normalerweise im Hintergrund würde, zur Laufzeit ausgeführt werden abgebrochen wird. Hinweis Diese Option kann temporär oder permanent Speicherplatz in der Datenbank verloren gehen. Verlorenen Speicherplatz kann immer durch eine Offlinedefragmentierung der Datenbank wiederhergestellt werden. |
JET_bitTermStopBackup |
Anforderungen, die die Instanz heruntergefahren werden, auch wenn gerade aktuell eine Sicherung vorhanden ist. Normalerweise würde eine anstehende Sicherung JetTerm ist mit JET_errBackupInProgress fehl. Wenn dieser Parameter nicht vorhanden ist, wird davon ausgegangen, dass der Wert JET_bitTermAbrupt werden. |
JET_bitTermDirty |
Anforderungen, die die Instanz mit der angefügten Datenbanken linken inkonsistent heruntergefahren werden. Windows 7: JET_bitTermDirty ist in Windows 7 eingeführt. |
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_errBackupInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Sicherungsvorgang für die Instanz ausgeführt wird. |
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_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.
Wenn diese Funktion durch ein Anwendungsfehler fehlschlägt, bleibt die Instanz im initialisierten Zustand, und ändert sich nichts. Andernfalls wird die Instanz noch heruntergefahren für den Erfolgsfall entfernen. 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
Finden Sie unter JetTerm ist.
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
JetTerm ist