JetTerm-Funktion

Gilt für: Windows | Windows Server

JetTerm-Funktion

Die JetTerm-Funktion initiiert das Herunterfahren einer instance, die von JetInit initialisiert wurde.

JetTerm kann auch verwendet werden, um eine nicht initialisierte instance zu zerstören, die von JetCreateInstance erstellt wurde.

    JET_ERR JET_API JetTerm(
      __in          JET_INSTANCE instance
    );

Parameter

instance

Gibt die instance an, die für diesen Aufruf verwendet werden sollen.

Windows 2000: Dieser Parameter wird ignoriert und sollte immer NULL sein.

Windows XP und höhere Versionen: Dieser Parameter ist überladen. Wenn die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) ausgeführt wird, in dem nur eine instance unterstützt wird, ist dieser Parameter möglicherweise NULL oder enthält den tatsächlichen instance, der von JetInit zurückgegeben wird. Wenn die Engine im Modus mit mehreren instance ausgeführt wird, muss dieser Parameter ein Zeiger auf eine instance sein, die mit JetCreateInstance erstellt wurde.

Rückgabewert

Diese Funktion gibt den JET_ERR-Datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu möglichen ESE-Fehlern finden Sie unter Erweiterbare Speichermodulfehler und Fehlerbehandlungsparameter.

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 ergab ein unerwartetes Ergebnis. Dieser Fehler wird von JetTerm zurückgegeben, wenn sich das Modul im Multi-instance-Modus befindet und wenn sich die Pinstance auf eine ungültige instance bezieht. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt.
JET_errNotInitialized	Der Vorgang kann nicht abgeschlossen werden, da der instance noch nicht initialisiert wurde.
JET_errTermInProgress	Der Vorgang kann nicht abgeschlossen werden, da die instance heruntergefahren wird.
JET_errRestoreInProgress	Es ist nicht möglich, den Vorgang abzuschließen, da auf dem instance ein Wiederherstellungsvorgang ausgeführt wird.
JET_errBackupInProgress	Der Vorgang kann nicht abgeschlossen werden, da auf dem instance ein Sicherungsvorgang ausgeführt wird.
JET_errTooManyActiveUsers	Die instance kann nicht heruntergefahren werden, da derzeit Sitzungen mit aktiven Transaktionen für die angegebene instance vorhanden sind. Dieser Fehler tritt nur auf, wenn die JET_bitTermComplete verwendet wird.

Wenn diese Funktion erfolgreich ist, wird die angegebene instance heruntergefahren. Das instance-Handle wird ebenfalls geschlossen und für jede API, die ein instance Handle benötigt, nicht verfügbar gemacht. Alle anderen Objekte, die dem instance zugeordnet sind, z. B. Sitzungen, werden ebenfalls geschlossen. Der Status der Prüfpunktdatei, der Transaktionsprotokolldateien und der Datenbankdateien, die an die instance angefügt sind, werden während des Herunterfahrens geändert.

Wenn diese Funktion aufgrund eines Verwendungsfehlers fehlschlägt, bleibt die instance in einem initialisierten Zustand, und es ändert sich nichts. Andernfalls wird die instance gemäß dem Erfolgsfall weiterhin heruntergefahren. Der Unterschied besteht darin, dass die instance bei der nächsten Initialisierung die Absturzwiederherstellung durchlaufen muss. Die Engine versucht, so viele Daten wie möglich zu leeren, um die erforderliche Wiederherstellungsmenge zu minimieren. Konzeptionell unterscheidet sich ein solcher Ausfall von JetTerm nicht von einem Prozessabsturz.

Bemerkungen

Wenn der Hostprozess eines instance aus irgendeinem Grund beendet wird, bevor JetTerm auf diesem instance erfolgreich aufgerufen wird, wird der instance als abgestürzt betrachtet. Die Absturzwiederherstellung erfolgt beim nächsten Versuch, diese instance zu initialisieren.

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.
Kopfzeile	Deklariert in Esent.h.
Bibliothek	Verwenden Sie ESENT.lib.
DLL	Erfordert ESENT.dll.

Weitere Informationen

Erweiterbare Speichermoduldateien
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm2