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