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