JetStopService-Funktion

  • Artikel
  • 2 Minuten Lesedauer

Gilt für: Windows | Windows Server

JetStopService-Funktion

Die JetStopService-Funktion bereitet eine Instanz für die Beendigung vor.

JetStopService ist der Legacyaufruf, wenn nur eine Instanz zulässig ist. In diesem Fall ist die einzige aktive Instanz die für die Beendigung vorbereitete Instanz.

    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 den möglichen ESE-Fehlern finden Sie unter Erweiterbarkeit Storage Modulfehler und Fehlerbehandlungsparameter.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errRunningInMultiInstanceMode

Es ist nicht klar, welche Instanz beim Verwenden von JetStopService mit mehreren Instanzenmodus für die Beendigung vorbereitet werden soll.

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 Kündigung ergriffenen Schritte umfassen folgendes:

  • Beenden Sie die Online-Defragmentierung, wenn sie ausgeführt wird.

  • Starten Sie eine Bereinigung des Versionsspeichers.

  • Verringern Sie die Prüfpunkttiefe, indem Sie mit dem Leeren von schmutzigen Seiten im Puffer-Manager beginnen.

  • Verhindern Sie zukünftige Aufrufe für die meisten Funktionen für diese Instanz.

Wenn diese Funktion fehlschlägt, werden keine der Schritte zur Vorbereitung auf die Beendigung einer Instanz ausgeführt, sodass keine Änderung des Instanzzustands auftritt.

Bemerkungen

Diese Funktion reduziert die Arbeit, die die Instanz beim Beenden ausführen muss, die Instanz jedoch nicht beendet. Daher ist diese Funktion nur eine Optimierung und ist nicht zwingend erforderlich. Beachten Sie, dass die Arbeit bei der Vorbereitung weniger in Windows 2000 und Windows XP war. Sobald die Funktion erfolgreich verläuft, werden aufrufende Funktionen, die nicht mehr zulässig sind, JET_errClientRequestToStopJetService zurückgegeben. Funktionen, die nach diesem Aufruf noch zulässig sind: JetRollback, JetCloseTable, JetEndSession, JetCloseDatabase, JetDetachDatabase und JetResetSessionContext.

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.

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