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 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_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete instance noch nicht initialisiert wurde. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf der instance, die der Sitzung zugeordnet ist, aufgrund eines Aufrufs von JetStopService beendet wurden. |
JET_errInstanceUnavailable |
Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt. Der Vorgang kann nicht abgeschlossen werden, da für die instance, die der Sitzung zugeordnet ist, ein schwerwiegender Fehler aufgetreten ist, bei dem der Zugriff auf alle Daten widerrufen werden muss, um die Integrität dieser Daten zu schützen. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die der Sitzung zugeordnete instance heruntergefahren wird. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die instance ausgeführt wird, die der Sitzung zugeordnet ist. |
JET_errNoBackup |
Der Vorgang ist fehlgeschlagen, weil keine externe Sicherung ausgeführt wird. |
JET_errBackupAbortByServer |
Windows Server 2003: Dieser Rückgabewert wird in Windows Server 2003 eingeführt. Der Vorgang ist fehlgeschlagen, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackup abgebrochen wurde. |
errBackupAbortByCaller |
Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt. Der Aufrufer beendete eine Sicherung in der Mitte der Sicherungssequenz, ohne die Absicht mit JetStopBackup zu signalisieren. Dieser Fehler ist das Ergebnis eines Fehlers im Sicherungsclient in Windows Server 2003 und höher. Unter Windows XP wird dieser Fehler für eine absichtliche Beendigung der externen Sicherungssequenz zurückgegeben. |
JET_errRunningInMultiInstanceMode |
Der Vorgang ist fehlgeschlagen, weil versucht wurde, die Engine im Legacymodus (Windows 2000-Kompatibilitätsmodus) zu verwenden, in dem nur eine instance unterstützt wird, wenn tatsächlich bereits mehrere Instanzen vorhanden sind. |
Wenn diese Funktion erfolgreich ist, war die externe Sicherung erfolgreich. Success gibt an, dass alle Dateien (z. B. Datenbanken und Protokolle), die für den Sicherungstyp (angegeben in JetBeginExternalBackup) geeignet sind, von der Sicherungs-Engine abgerufen wurden. Die gesicherten Dateien können mit harter Wiederherstellung (JetExternalRestore) wiederhergestellt werden.
Wenn diese Funktion fehlschlägt, endet die externe Sicherung in der Regel. Fehler bedeutet, dass die Sicherung aufgrund eines Client- oder Anwendungsnutzungsfehlers ungültig ist. Es ist wichtig, den Rückgabecode für diese API zu überprüfen, um zu überprüfen, ob die Sicherungssequenz erfolgreich war.
Bemerkungen
Wenn die Engine für das Protokollieren von Ereignissen konfiguriert ist, wird ein Ereignis protokolliert, um die Auflösung der externen Sicherung anzugeben.
Wenn die Sicherungssequenz nicht in der 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 Sequenz der externen Sicherungs-API finden Sie unter JetBeginExternalBackup.
Wenn die Protokollkürzung vor Windows Vista nicht durchgeführt wurde, hat die Engine davon ausgegangen, dass es sich bei der Sicherung um eine Kopiesicherung handelt. Die Sicherung kann jedoch eine normale Sicherung sein, für die keine Abschneidung 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. |
Kopfzeile |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
Fehlerbehandlungsparameter
Fehler der erweiterbaren Speicher-Engine
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog