JetBeginExternalBackupInstance-Funktion
Gilt für: Windows | Windows Server
JetBeginExternalBackupInstance-Funktion
Die JetBeginExternalBackupInstance-Funktion initiiert eine externe Sicherung, während engine und database 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
Instanz
Die Datenbankinstanz, 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 Instanz unterstützt wird. Die Verwendung dieser globalen Instanz wird in diesem Fall impliziert.
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.
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 kann als Ergebnis eines Aufrufs dieser Funktion Erfolgs- oder Fehlercodes generieren. Eine vollständige Liste der Fehler für diese API finden Sie unter Extensible Storage Engine Error Codes.
Weitere Informationen finden Sie unter JetBeginExternalBackup.
Bemerkungen
JetBeginExternalBackupInstance ist die erste Funktion in einer Reihe von Funktionen, die aufgerufen werden müssen, 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 zu diesem Zeitpunkt nicht möglich ist.
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. |
Header |
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