JetStopService-Funktion
Gilt für: Windows | Windows Server
JetStopService-Funktion
Die JetStopService-Funktion bereitet eine instance für die Beendigung vor.
JetStopService ist der Legacyaufruf, wenn nur ein instance zulässig ist. In diesem Fall ist die einzige aktive instance, die für die Beendigung vorbereitet wird.
JET_ERR JET_API JetStopService(void);
Parameter
Diese Funktion besitzt keine Parameter.
Rückgabewert
Diese Funktion gibt den Datentyp JET_ERR 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_errRunningInMultiInstanceMode |
Es ist nicht klar, welche instance bei Verwendung von JetStopService mit mehreren instance Modus auf die Beendigung vorbereitet werden sollen. Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt. |
Wenn diese Funktion erfolgreich ist, bereitet sie sich auf eine zukünftige Beendigung vor. Die zur Vorbereitung einer Beendigung unternommenen Schritte umfassen Folgendes:
Beenden Sie die Online-Defragmentierung, wenn sie ausgeführt wird.
Starten Sie einen Versionsspeicher sauber.
Verringern Sie die Prüfpunkttiefe, indem Sie beginnen, modifiziert Seiten im Puffer-Manager zu leeren.
Verhindern Sie zukünftige Aufrufe der meisten Funktionen für diese instance.
Wenn diese Funktion fehlschlägt, wird keiner der Schritte zur Vorbereitung einer instance Beendigung ausgeführt, sodass keine Änderung des instance Zustands erfolgt.
Bemerkungen
Diese Funktion reduziert die Arbeit, die der instance beim Beenden erledigen muss, beendet aber nicht die instance. Daher ist diese Funktion nur eine Optimierung und nicht zwingend erforderlich. Beachten Sie, dass der Aufwand für die Vorbereitung in Windows 2000 und Windows XP geringer war. Sobald die Funktion erfolgreich ist, gibt das Aufrufen nicht mehr zulässiger Funktionen JET_errClientRequestToStopJetService zurück. Funktionen, die nach diesem Aufruf weiterhin zulässig sind, sind: JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase und JetResetSessionContext.
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
JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2