JetEndExternalBackup-Funktion

Gilt für: Windows | Windows Server

JetEndExternalBackup-Funktion

Die JetEndExternalBackup-Funktion beendet eine externe Sicherungssitzung. Diese Funktion ist das letzte API-Element in einer Reihe von API-Elementen, die aufgerufen werden müssen, um eine erfolgreiche Onlinesicherung (nicht AUF VSS basierend) auszuführen.

    JET_ERR JET_API JetEndExternalBackup(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_errNotInitialized

Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde.

JET_errClientRequestToStopJetService

Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf der Instanz, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopServicebeendet wurden.

JET_errInstanceUnavailable

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

Der Vorgang kann nicht abgeschlossen werden, da für die Instanz, die der Sitzung zugeordnet ist, ein schwerwiegender Fehler aufgetreten ist, der erfordert, dass der Zugriff auf alle Daten widerrufen wird, um die Integrität dieser Daten zu schützen.

JET_errTermInProgress

Der Vorgang kann nicht abgeschlossen werden, da die instanz, die der Sitzung zugeordnet ist, heruntergefahren wird.

JET_errRestoreInProgress

Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, die der Sitzung zugeordnet ist.

JET_errNoBackup

Fehler beim Vorgang, weil keine externe Sicherung ausgeführt wird.

JET_errBackupAbortByServer

Windows Server 2003: Dieser Rückgabewert wird in Windows Server 2003 eingeführt.

Fehler beim Vorgang, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackupabgebrochen wurde.

errBackupAbortByCaller

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

Der Aufrufer hat eine Sicherung in der Mitte der Sicherungssequenz beendet, ohne die Absicht mit JetStopBackup zu signalisieren. Dieser Fehler ist auf einen Fehler im Sicherungsclient in Windows Server 2003 und höher zurückzuführen. Bei Windows XP wird dieser Fehler für eine absichtliche Beendigung der externen Sicherungssequenz zurückgegeben.

JET_errRunningInMultiInstanceMode

Fehler beim Vorgang, weil versucht wurde, die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) zu verwenden, wobei nur eine Instanz unterstützt wird, obwohl tatsächlich bereits mehrere Instanzen vorhanden sind.

Wenn diese Funktion erfolgreich ausgeführt wird, war die externe Sicherung erfolgreich. Erfolg gibt an, dass alle Dateien (z. B. Datenbanken und Protokolle), die für den Sicherungstyp geeignet sind (angegeben in JetBeginExternalBackup),von der Sicherungs-Engine abgerufen wurden. Die gesicherten Dateien können mit harter Wiederherstellung wiederhergestellt werden (JetExternalRestore).

Wenn diese Funktion fehlschlägt, wird die externe Sicherung in der Regel beendet. Fehler bedeutet, dass die Sicherung aufgrund eines Client- oder Anwendungsverwendungsfehlers ungültig ist. Es ist wichtig, den Rückgabecode für diese API zu überprüfen, um sicherzustellen, dass die Sicherungssequenz erfolgreich war.

Bemerkungen

Wenn die Engine zum Protokollieren von Ereignissen konfiguriert ist, wird ein Ereignis protokolliert, um die Auflösung der externen Sicherung anzugeben.

Wenn die Sicherungssequenz nicht in der angegebenen Reihenfolge und mit einem erfolgreichen Aufruf von JetEndExternalBackup abgeschlossen wird, enthalten nachfolgende inkrementelle Sicherungen möglicherweise mehr Daten als von der Anwendung erwartet.

Weitere Informationen zur API-Sequenz für externe Sicherungen finden Sie unter JetBeginExternalBackup.

Wenn die Protokollkürzung nicht durchgeführt wurde, hat die Engine vor Windows Vista davon ausgegangen, dass es sich bei der Sicherung um eine Kopiersicherung handelt. Die Sicherung kann jedoch eine normale Sicherung sein, für die keine Kürzung durchgeführt wurde (z. B. wenn getrennte Datenbanken vorhanden sind). Die option JET_bitBackupTruncateDone kann verwendet werden, um die Engine darüber zu informieren und entsprechende Änderungen an Datenbankheadern zuzulassen.

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

Deklariert in Esent.h.

Bibliothek

Verwenden Sie ESENT.lib.

DLL

Erfordert ESENT.dll.

Weitere Informationen

Fehlerbehandlungsparameter
Extensible Storage Engine Errors (Erweiterbare Storage-Engine-Fehler)
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog