JetTerm2-Funktion
Gilt für: Windows | Windows Server
JetTerm2-Funktion
Die JetTerm2-Funktion initiiert das Herunterfahren einer Instanz, die von JetInitinitialisiert wurde.
JetTerm2 kann auch eine nicht initialisierte Instanz zerstören, die von JetCreateInstanceerstellt wurde.
JET_ERR JET_API JetTerm2(
__in JET_INSTANCE instance,
__in JET_GRBIT grbit
);
Parameter
Instanz
Die -Instanz, 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.
grbit
Eine Gruppe von Bits, die die für diesen Aufruf zu verwendenden Optionen enthalten, die null oder mehr der folgenden Werte enthalten.
Wert |
Bedeutung |
|---|---|
JET_bitTermComplete |
Fordert an, dass die Instanz sauber heruntergefahren wird. Alle optionalen Bereinigungsarbeiten, die normalerweise zur Laufzeit im Hintergrund ausgeführt werden, werden sofort abgeschlossen. |
JET_bitTermAbrupt |
Fordert an, dass die Instanz so schnell wie möglich heruntergefahren wird. Alle optionalen Arbeiten, die normalerweise zur Laufzeit im Hintergrund ausgeführt werden, werden abgebrochen. Hinweis Diese Option kann zu temporärem oder dauerhaftem Speicherplatzverlust in der Datenbank führen. Dieser verlorene Speicherplatz kann immer durch eine Offlinedefragmentierung der Datenbank wiederhergestellt werden. |
JET_bitTermStopBackup |
Fordert an, dass die Instanz heruntergefahren wird, auch wenn derzeit eine Sicherung ausgeführt wird. Normalerweise würde eine ausstehende Sicherung dazu führen, dass JetTerm mit JET_errBackupInProgress fehlschlägt. Wenn dieser Parameter nicht vorhanden ist, wird davon ausgegangen, dass sein Wert JET_bitTermAbrupt ist. |
JET_bitTermDirty |
Fordert an, dass die Instanz mit allen angefügten Datenbanken heruntergefahren wird, die sich in einem geänderten Zustand befinden. Windows 7: JET_bitTermDirty wird in Windows 7 eingeführt. |
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 Extensible Storage Engine Errors and Error Handling Parameters.
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 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_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 wie im Erfolgsfall angegeben 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
Weitere Informationen finden Sie unter JetTerm.
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
JetTerm