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
Instanz
Die -Instanz, die für diesen Aufruf verwendet werden soll.
Windows 2000: Für Windows 2000 ist die API-Variante, die diesen Parameter akzeptiert, nicht verfügbar, da nur eine Instanz unterstützt wird. Die Verwendung dieser globalen Instanz wird 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 die Engine im Legacymodus befindet (Windows Kompatibilitätsmodus 2000), in dem nur eine Instanz 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 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_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 das Ergebnis eines Fehlers im Sicherungsclient in Windows Server 2003 und höher. Bei 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. Fehler beim Vorgang, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackupabgebrochen 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_errNoBackup |
Fehler beim Vorgang, weil keine externe Sicherung ausgeführt wird. |
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die der Sitzung zugeordnet ist, noch nicht initialisiert wurde. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da ein Wiederherstellungsvorgang für die Instanz ausgeführt wird, die der Sitzung zugeordnet ist. |
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. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die instanz, die der Sitzung zugeordnet ist, heruntergefahren wird. |
Wenn die Funktion erfolgreich war, 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 JetEndExternalBackupabgeschlossen 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 JET_bitBackupTruncateDone Option kann verwendet werden, um die Engine darüber zu informieren und ordnungsgemäße Änderungen des Datenbankheaders zuzulassen.
Anforderungen
| Anforderung | Wert |
|---|---|
Client |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert Windows Server 2008 oder Windows Server 2003. |
Header |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
Fehlerbehandlungsparameter
Erweiterbare Storage-Engine-Fehler
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog