JetEndExternalBackupInstance2-Funktion
Letzte Änderung: Freitag, 27. Februar 2015
Gilt für: Windows | Windows Server
JetEndExternalBackupInstance2-Funktion
Die JetEndExternalBackupInstance2 -Funktion wird eine externe backup-Sitzung beendet. Diese API ist die letzte API in einer Reihe von APIs, die aufgerufen werden muss, um eine erfolgreiche online (nicht-VSS-basierten) Sicherung ausführen.
Windows XP:JetEndExternalBackupInstance2 wird in Windows XP eingeführt.
JET_ERR JET_API JetEndExternalBackupInstance2(
__in JET_INSTANCE instance,
__in JET_GRBIT grbit
);
Parameter
Instance
Die Instanz, die für diesen Aufruf verwenden.
**Windows 2000:**Für Windows 2000 ist die API-Variante, die für diesen Parameter kann nicht verfügbar, da nur eine einzige Instanz unterstützt wird. In diesem Fall wird die Verwendung dieser eine globale Instanz impliziert.
**Windows XP:**Für Windows XP und spätere Versionen kann die API-Variante, die keine dieser Parameter akzeptiert nur aufgerufen werden, wenn das Modul im legacy-Modus (Windows 2000-Kompatibilitätsmodus) ist, in denen nur eine einzige Instanz unterstützt. Andernfalls wird der Vorgang mit JET_errRunningInMultiInstanceMode fehl.
JET_errInvalidGrbit
Eine Gruppe von Bits an, die 0 (null) oder mehrere der folgenden Optionen angibt.
Wert |
Bedeutung |
|---|---|
JET_bitBackupEndAbort |
Die Client-Anwendung wird die Sicherung abgebrochen. |
JET_bitBackupEndNormal |
Die Clientanwendung wird normalerweise beendet und die Sicherung vollständig abgeschlossen. |
JET_bitBackupTruncateDone |
Windows Vista:JET_bitBackupTruncateDone wird in Windows Vista eingeführt. Das Modul kann die Kopfzeilen der Datenbank (beispielsweise eine vollständige Sicherung abgeschlossen) entsprechend markieren, obwohl der Aufruf zu kürzende nicht abgeschlossen wurde. |
Return Value
Diese Funktion gibt den Datentyp JET_ERR mit einem der folgenden Rückgabecodes. Weitere Informationen zu den möglichen ESE-Fehlern finden Sie unter Extensible Storage Engine-Fehlern und Fehler behandeln von Parametern.
Rückgabecode |
Beschreibung |
|---|---|
JET_errSuccess |
Der Vorgang wurde erfolgreich abgeschlossen. |
JET_errBackupAbortByCaller |
Windows XP:Dieser Wert wird in Windows XP eingeführt. Der Aufrufer beendet eine Sicherung in der Mitte der Sicherung Sequenz ohne die Absicht mit JetStopBackupSignale. Dieser Fehler ist ein Fehler im backup-Client in Windows Server 2003 und höher. Dieser Fehler wird in Windows XP für eine beabsichtigt Beendigung der externen backup Sequenz zurückgegeben. |
JET_errBackupAbortByServer |
WindowsServer 2003:Dieser Wert wird in Windows Server 2003 eingeführt. Der Vorgang fehlgeschlagen ist, weil die aktuelle externe Sicherung durch einen Aufruf von JetStopBackupabgebrochen wurde. |
JET_errClientRequestToStopJetService |
Der Vorgang kann nicht abgeschlossen werden, da alle Aktivitäten auf die Instanz, die die Sitzung zugeordnet ist aufgrund eines Aufrufs von JetStopServicebehoben ist. |
JET_errInstanceUnavailable |
Windows XP:Dieser Wert wird in Windows XP eingeführt. Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die die Sitzung zugeordnet ist, ein schwerwiegender Fehler, der erforderlich sind aufgetreten, dass der Zugriff auf alle Daten gesperrt werden, um die Integrität der Daten zu schützen. |
JET_errNoBackup |
Der Vorgang fehlgeschlagen ist, weil keine externen Sicherung ausgeführt wird. |
JET_errNotInitialized |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die die Sitzung zugeordnet ist noch nicht initialisiert wurde. |
JET_errRestoreInProgress |
Der Vorgang kann nicht abgeschlossen werden, da eine Wiederherstellung ausgeführt auf die Instanz wird, der die Sitzung zugeordnet ist. |
JET_errRunningInMultiInstanceMode |
Fehler bei der versucht wurde, verwenden Sie das Modul im legacy-Modus (Windows 2000-Kompatibilitätsmodus), in denen wird nur eine einzige Instanz unterstützt, wenn mehrere Instanzen tatsächlich bereits vorhanden sein, der Vorgang. |
JET_errTermInProgress |
Der Vorgang kann nicht abgeschlossen werden, da die Instanz, die die Sitzung zugeordnet ist Herunterfahren. |
Wenn die Funktion erfolgreich ist, war die externe Sicherung ein Erfolg. Erfolg bedeutet, dass alle Dateien (beispielsweise Datenbanken und Protokolle), die für den Typ der Sicherung (in JetBeginExternalBackupangegeben) werden von der backup-Engine abgerufen wurden. Die gesicherten Dateien können mit hard Recovery (JetExternalRestore) wiederhergestellt werden.
Wenn diese Funktion fehlschlägt, wird die externe Sicherung in der Regel beendet. Failure bedeutet, dass die Sicherung aufgrund von einem Client oder einer Anwendung Anwendungsfehler ungültig ist. Es ist wichtig, überprüfen Sie den Rückgabecode für diese API, um sicherzustellen, dass die Sicherung Abfolge erfolgreich war.
Anmerkungen
Wenn das Modul zum Protokollieren von Ereignissen konfiguriert ist, wird ein Ereignis protokolliert, um die Auflösung der externen Sicherung anzugeben.
Wenn die Sicherung Sequenz in Reihenfolge und mit einem erfolgreichen Aufruf von JetEndExternalBackupnicht abgeschlossen wurde, können nachfolgende inkrementelle Sicherungen weitere Daten als die Anwendung beabsichtigt enthalten.
Weitere Informationen zu den externen backup API-Sequenz finden Sie unter JetBeginExternalBackup.
Vor Windows Vista, wenn das Abschneiden des Protokolls nicht vorgenommen wurde, ausgegangen das Modul, dass die Sicherung einer Kopie-Sicherung. Die Sicherung einer normalen Sicherung möglicherweise jedoch für die Abschneiden nicht durchgeführt wurde, (z. B., wenn getrennte Datenbanken vorhanden sind). Die Option JET_bitBackupTruncateDone kann das Modul halten Sie davon zu informieren und ermöglichen Änderungen an die gewünschte Datenbank-Kopfzeilen verwendet werden.
Voraussetzungen
-Client, |
Erfordert Windows Vista oder Windows XP. |
Server |
Erfordert WindowsServer 2008 oder WindowsServer 2003. |
Kopfzeile |
In Esent.h deklariert. |
Library |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert "ESENT.dll". |
Siehe auch
Parameter für die Fehlerbehandlung
Extensible Storage Engine Fehler
JET_ERR
JET_GRBIT
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog