JetStopServiceInstance-Funktion

Gilt für: Windows | Windows Server

JetStopServiceInstance-Funktion

Die JetStopServiceInstance-Funktion bereitet einen instance für die Beendigung vor.

Windows XP:JetStopServiceInstance wird in Windows XP eingeführt.

    JET_ERR JET_API JetStopServiceInstance(
      __in          JET_INSTANCE instance
    );

Parameter

instance

Die ausgeführte instance, die für den API-Aufruf verwendet werden soll.

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_errInvalidParameter	Der angegebene parameter instance hat einen ungültigen Wert (kein instance, der derzeit ausgeführt wird). 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 die 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 oder Windows XP.
Server	Erfordert Windows Server 2008 oder Windows Server 2003.
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