Condividi tramite

Funzione JetBeginExternalBackupInstance

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetBeginExternalBackupInstance

La funzione JetBeginExternalBackupInstance avvia un backup esterno mentre il motore e il database sono online e attivi.

Windows XP: JetBeginExternalBackupInstance viene introdotto in Windows XP.

    JET_ERR JET_API JetBeginExternalBackupInstance(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

Parametri

Istanza

Istanza del database da usare per questa chiamata.

Per Windows 2000, la variante api che accetta questo parametro non è disponibile perché è supportata solo un'istanza. L'uso di questa istanza globale è implicito in questo caso.

Per le versioni successive e Windows XP, la variante API che non accetta questo parametro può essere chiamata solo quando il motore è in modalità legacy (modalità di compatibilità windows 2000) in cui è supportata solo un'istanza. In caso contrario, l'operazione avrà esito negativo con JET_errRunningInMultiInstanceMode.

grbit

Un gruppo di bit che specificano zero o più delle opzioni seguenti.

Valore

Significato

JET_bitBackupAtomic

Questo flag è deprecato. L'utilizzo di questo bit comporterà la restituzione di JET_errInvalidgrbit.

JET_bitBackupIncremental

Crea un backup incrementale anziché un backup completo. Ciò significa che solo i file di log dall'ultimo backup completo o incrementale verranno sottoposti a backup.

JET_bitBackupSnapshot

Riservato per utilizzi futuri. Definito per Windows XP.

Valore restituito

Il sistema può generare codici di esito positivo o di errore in seguito a una chiamata a questa funzione. Per un elenco completo degli errori per questa API, vedere Codici di errore del motore di archiviazione estendibili.

Vedere JetBeginExternalBackup.

Commenti

JetBeginExternalBackupInstance è la prima funzione in una serie di funzioni che devono essere chiamate per eseguire un backup online (non basato su VSS). Vedere anche JetBeginExternalBackup e JetStopBackupInstance.

È possibile usare un backup esterno per implementare backup completi, incrementali o differenziali.

Il backup sarà fuzzy, in quanto il backup sarà coerente con un singolo punto nel tempo nella cronologia delle transazioni, ma il controllo del punto esatto in tempo non è possibile in questo momento.

Requisiti

Requisito Valore

Client

Richiede Windows Vista, Windows XP o Windows 2000 Professional.

Server

Richiede Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Intestazione

Dichiarato in Esent.h.

Libreria

Usare ESENT.lib.

DLL

Richiede ESENT.dll.

Vedere anche

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog