JetStopBackup-Funktion

Gilt für: Windows | Windows Server

JetStopBackup-Funktion

Die JetStopBackup-Funktion verhindert, dass aktivitäten im Zusammenhang mit Streamingsicherungen auf einer bestimmten ausgeführten Instanz fortgesetzt werden, wodurch die Streamingsicherung auf vorhersagbare Weise beendet wird.

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

JetStopService ist der Legacyaufruf, wenn nur eine Instanz zulässig ist. In diesem Fall ist die einzige aktive Instanz die Instanz, 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 JET_ERR datentyp mit einem der folgenden Rückgabecodes zurück. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine Errors and Error Handling Parameters.

Rückgabecode

Beschreibung

JET_errSuccess

Der Vorgang wurde erfolgreich abgeschlossen.

JET_errRunningInMultiInstanceMode

Es ist nicht klar, welche Instanz für die Beendigung vorbereitet werden soll, wenn JetStopService mit dem Modus für mehrere Instanzen verwendet wird.

Windows XP: Dieser Rückgabewert wird in xp Windows eingeführt.

Wenn diese Funktion erfolgreich ist, tritt bei der Instanz ein Fehler bei allen neuen Streamingsicherungs-APIs auf.

Wenn diese Funktion fehlschlägt, werden keine Schritte zum Vorbereiten der Sicherungsbeendigung auf der Instanz und keine Änderung des Instanzzustands unternommen.

Bemerkungen

Die Sicherung wird in der Regel durch ein Ereignis außerhalb des Prozessmechanismus ausgelöst, und mit dieser API ruft die ESENT-Anwendung selbst alle weiteren Aufrufe der Streamingsicherungs-APIs auf, um einen Fehler zu erhalten. Der Großteil der Streamingsicherungs-APIs wird mit einem Fehler JET_errBackupAbortByServer. Daher wird bei jedem Streamingsicherungsfortschritt (z. B. JetReadFileInstance)ein Fehler zurückgegeben. 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.

Header

Wird in Esent.h deklariert.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

JetEndExternalBackupInstance
JET_ERR
JET_INSTANCE
JetReadFileInstance
JetStopService