JetEndExternalBackup-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetEndExternalBackup-Funktion
Die JetEndExternalBackup -Funktion wird eine externe backup-Sitzung beendet. Diese Funktion ist der letzten API-Element in einer Reihe von API-Elemente, die zum Ausführen einer Sicherung erfolgreich online (nicht-VSS-basierte) aufgerufen werden muss.
JET_ERR JET_API JetEndExternalBackup(void);
Parameter
Diese Funktion hat keine Parameter.
Return Value
Diese Funktion gibt den Datentyp der JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehler und Fehler behandeln Parameter.
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 wurde wurde noch nicht wurde initialisiert. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf die Instanz, die mit der Sitzung ist, aufgrund eines Aufrufs von JetStopServiceeingestellt hat. |
JET_errInstanceUnavailable |
Windows XP:Dieser Rückgabewert wird in Windows XP eingeführt. Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die mit der Sitzung ist, eine schwerwiegende aufgetreten Fehler, der Zugriff auf alle Daten benötigt zum Schutz der Integrität von Daten gesperrt werden. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da das Herunterfahren der Instanz, die die Sitzung zugeordnet ist. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, dem die Sitzung zugeordnet ist. |
JET_errNoBackup |
Der Vorgang ist fehlgeschlagen, da keine externe Sicherung ausgeführt wird. |
JET_errBackupAbortByServer |
WindowsServer 2003:Dieser Rückgabewert wird in Windows Server 2003 eingeführt. Der Vorgang ist fehlgeschlagen, da ein Aufruf von JetStopBackupdie aktuelle externe Sicherung abgebrochen wurde. |
errBackupAbortByCaller |
Windows XP:Dieser Rückgabewert wird in Windows XP eingeführt. Der Aufrufer eine Sicherung in der Mitte die Folge von Protokollsicherungen ohne damit die Absicht mit JetStopBackupeingestellt. Dieser Fehler ist ein Ergebnis eines Fehlers in der backup-Client in Windows Server 2003 und höher. Dieser Fehler wird unter Windows XP für eine vorsätzliche Beendigung der externen backup-Sequenz zurückgegeben. |
JET_errRunningInMultiInstanceMode |
Der Vorgang ist fehlgeschlagen, da versucht wurde, die Engine im legacy-Modus (Windows 2000-Kompatibilitätsmodus), wird nur eine Instanz unterstützt, wenn tatsächlich bereits mehrere Instanzen vorhanden sind, verwenden. |
Wenn diese Funktion erfolgreich ist, war die externe Sicherung erfolgreich. Erfolg bedeutet, dass alle Dateien (z. B. Datenbanken und Protokolle), die für den Typ der Sicherung (angegeben in JetBeginExternalBackup) werden von der backup-Engine abgerufen wurden. Mit hard Recovery-Vorgang (JetExternalRestore) können die gesicherten Dateien wiederhergestellt werden.
Wenn diese Funktion fehlschlägt, wird die externe Sicherung in der Regel beendet. Fehler bedeutet, dass die Sicherung durch einen Client oder einen Anwendungsfehler Verwendung ungültig ist. Es ist wichtig zu überprüfen, den Rückgabecode für diese API, um sicherzustellen, dass die Folge von Protokollsicherungen erfolgreich war.
Anmerkungen
Wenn das Modul zum Protokollieren von Ereignissen konfiguriert ist, wird ein Ereignis protokolliert, um die Auflösung der externe Sicherung anzugeben.
Wenn die Folge von Protokollsicherungen in der Reihenfolge und mit einem erfolgreichen Aufruf von JetEndExternalBackupnicht abgeschlossen ist, könnten nachfolgende inkrementelle Backups mehr Daten als erwartet Anwendung enthalten.
Weitere Informationen über die externe API Folge von Protokollsicherungen finden Sie unter JetBeginExternalBackup.
Vor Windows Vista Wenn die Protokollkürzung nicht durchgeführt wurde, hält das Modul die Sicherung einer Kopie-Sicherung. Die Sicherung bei einer normalen Sicherung möglicherweise jedoch für die Kürzung nicht durchgeführt wurde, (z. B. wenn getrennte Datenbanken vorhanden sind). Die JET_bitBackupTruncateDone-Option kann verwendet werden, um das Modul darüber zu informieren und Zulassen von Änderungen an der entsprechenden Datenbank-Kopfzeilen.
Voraussetzungen
-Client, |
Erfordert Windows Vista, Windows XP oder Windows 2000 Professional. |
Server |
Erfordert WindowsServer 2008, WindowsServer 2003 oder Windows 2000 Server. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
"ESENT.dll" erfordert. |
Siehe auch
Parameter zur Fehlerbearbeitung
Fehler von Extensible Storage Engine
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog