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