JetBeginExternalBackupInstance-Funktion
Gilt für: Windows | Windows Server
JetBeginExternalBackupInstance-Funktion
Die JetBeginExternalBackupInstance-Funktion initiiert eine externe Sicherung, während die Engine und die Datenbank online und aktiv sind.
Windows XP: JetBeginExternalBackupInstance wird in Windows XP eingeführt.
JET_ERR JET_API JetBeginExternalBackupInstance(
__in JET_INSTANCE instance,
__in JET_GRBIT grbit
);
Parameter
instance
Die Datenbank instance, die für diesen Aufruf verwendet werden soll.
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.
Bei Windows XP und höheren 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.
grbit
Eine Gruppe von Bits, die null oder mehr der folgenden Optionen angibt.
Wert |
Bedeutung |
---|---|
JET_bitBackupAtomic |
Dieses Flag ist veraltet. Die Verwendung dieses Bits führt dazu, dass JET_errInvalidgrbit zurückgegeben wird. |
JET_bitBackupIncremental |
Erstellt eine inkrementelle Sicherung im Gegensatz zu einer vollständigen Sicherung. Dies bedeutet, dass nur die Protokolldateien seit der letzten vollständigen oder inkrementellen Sicherung gesichert werden. |
JET_bitBackupSnapshot |
Für die zukünftige Verwendung reserviert. Definiert für Windows XP. |
Rückgabewert
Das System generiert möglicherweise Erfolgs- oder Fehlercodes als Ergebnis eines Aufrufs dieser Funktion. Eine vollständige Liste der Fehler für diese API finden Sie unter Fehlercodes der Erweiterbaren Speicher-Engine.
Siehe JetBeginExternalBackup.
Bemerkungen
JetBeginExternalBackupInstance ist die erste Funktion in einer Reihe von Funktionen, die aufgerufen werden muss, um eine erfolgreiche Onlinesicherung (nicht VSS-basiert) auszuführen. Siehe auch JetBeginExternalBackup und JetStopBackupInstance.
Eine externe Sicherung kann verwendet werden, um vollständige, inkrementelle oder differenzielle Sicherungen zu implementieren.
Die Sicherung ist unscharf, da die Sicherung zu einem einzelnen Zeitpunkt im Transaktionsverlauf konsistent ist, aber das Steuern des genauen Zeitpunkts ist derzeit nicht möglich.
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. |
Kopfzeile |
Deklariert in Esent.h. |
Bibliothek |
Verwenden Sie ESENT.lib. |
DLL |
Erfordert ESENT.dll. |
Weitere Informationen
JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog