JetEndExternalBackupInstance-Funktion
Gilt für: Windows | Windows Server
JetEndExternalBackupInstance-Funktion
Die JetEndExternalBackupInstance-Funktion beendet eine externe Sicherungssitzung. Diese API ist die letzte API in einer Reihe von APIs, die aufgerufen werden muss, um eine erfolgreiche Onlinesicherung (nicht VSS-basiert) auszuführen.
Windows XP: JetEndExternalBackupInstance wird in Windows XP eingeführt.
JET_ERR JET_API JetEndExternalBackupInstance(
__in JET_INSTANCE instance
);
Parameter
instance
Die für diesen Aufruf zu verwendende instance.
Windows 2000: Für Windows 2000 ist die API-Variante, die diesen Parameter akzeptiert, nicht verfügbar, da nur eine instance unterstützt wird. Die Verwendung dieses globalen instance ist in diesem Fall impliziert.
Windows XP: Für Windows XP und höhere Versionen kann die API-Variante, die diesen Parameter nicht akzeptiert, nur aufgerufen werden, wenn sich das Modul im Legacymodus (Windows 2000-Kompatibilitätsmodus) befindet, in dem nur eine instance unterstützt wird. Andernfalls schlägt der Vorgang mit JET_errRunningInMultiInstanceMode fehl.
Rückgabewert
Diese Funktion gibt den JET_ERR-Datentyp 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_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_errBackupAbortByServer |
Windows Server 2003: Dieser Rückgabewert wird in Windows Server 2003 eingeführt. Der Vorgang ist fehlgeschlagen, da die aktuelle externe Sicherung durch einen Aufruf von JetStopBackup abgebrochen wurde. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf dem instance, die der Sitzung zugeordnet sind, aufgrund eines Aufrufs von JetStopService beendet wurde. |
JET_errInstanceUnavailable |
Windows XP: Dieser Rückgabewert wird in Windows XP eingeführt. Der Vorgang kann nicht abgeschlossen werden, da bei der instance, 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_errNoBackup |
Der Vorgang ist fehlgeschlagen, da keine externe Sicherung ausgeführt wird. |
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die instance, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die instance ausgeführt wird, die der Sitzung zugeordnet ist. |
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. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die instance, die der Sitzung zugeordnet ist, heruntergefahren wird. |
Wenn die Funktion erfolgreich ist, war die externe Sicherung erfolgreich. Erfolg gibt an, dass alle Dateien (z. B. Datenbanken und Protokolle), die für den Sicherungstyp (in JetBeginExternalBackup angegeben) geeignet sind, von der Sicherungs-Engine abgerufen wurden. Die gesicherten Dateien können mit der harten Wiederherstellung (JetExternalRestore) wiederhergestellt werden.
Wenn diese Funktion fehlschlägt, wird die externe Sicherung in der Regel beendet. 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 zum Protokollieren von Ereignissen konfiguriert ist, wird ein Ereignis protokolliert, um die Auflösung der externen Sicherung anzugeben.
Wenn die Sicherungssequenz nicht in der richtigen Reihenfolge und mit einem erfolgreichen Aufruf von JetEndExternalBackup abgeschlossen ist, 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 Protokollabkürzung vor Windows Vista nicht durchgeführt wurde, betrachtete das Modul die Sicherung als Kopiersicherung. Bei der Sicherung kann es sich jedoch um eine normale Sicherung handeln, für die nicht abgeschnitten wurde (z. B. wenn getrennte Datenbanken vorhanden sind). Die Option JET_bitBackupTruncateDone kann verwendet werden, um die Engine darüber zu informieren und geeignete Änderungen an Datenbankheadern zuzulassen.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert Windows Server 2008 oder Windows Server 2003. |
Kopfzeile |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
Fehlerbehandlungsparameter
Erweiterbare Speicher-Engine-Fehler
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog