JetStopBackup-Funktion

  • Artikel

Gilt für: Windows | Windows Server

JetStopBackup-Funktion

Die JetStopBackup-Funktion verhindert, dass alle streamingsicherungsbezogenen Aktivitäten auf einem bestimmten ausgeführten instance fortgesetzt werden, wodurch die Streamingsicherung auf vorhersagbare Weise beendet wird.

Windows XP: Diese Funktion wird in Windows XP eingeführt.

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 JetStopBackup(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, schlägt die instance neue Streamingsicherungs-APIs fehl.

Wenn diese Funktion fehlschlägt, werden keine Schritte zur Vorbereitung der Sicherungsbeendigung auf der instance ausgeführt, und es erfolgt keine Änderung des instance Zustands.

Bemerkungen

Die Sicherung wird in der Regel durch ein Ereignis außerhalb des Prozessmechanismus ausgelöst, und mithilfe dieser API führt die ESENT-Anwendung selbst alle weiteren Aufrufe der Streamingsicherungs-APIs durch, die fehlschlagen. Bei den meisten Streamingsicherungs-APIs tritt ein Fehler mit JET_errBackupAbortByServer auf. Daher gibt jeder Fortschritt der Streamingsicherung (z. B. JetReadFileInstance) einen Fehler zurück. Sicherungsvorgänge, die Teil der Sicherungsbeendigung sind (z. B. JetEndExternalBackupInstance), sind weiterhin zulässig.

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

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService