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