Funzione JetEndExternalBackup
Si applica a: Windows | Windows Server
Funzione JetEndExternalBackup
La funzione JetEndExternalBackup termina una sessione di backup esterna. Questa funzione è l'ultimo elemento API in una serie di elementi API che devono essere chiamati per eseguire un backup online (non basato su VSS).
JET_ERR JET_API JetEndExternalBackup(void);
Parametri
Questa funzione non ha parametri.
Valore restituito
Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.
Codice restituito |
Descrizione |
|---|---|
JET_errSuccess |
Operazione riuscita. |
JET_errNotInitialized |
Impossibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata. |
JET_errClientRequestToStopJetService |
L'operazione non può essere completata perché tutte le attività nell'istanza associata alla sessione sono cessate a seguito di una chiamata a JetStopService. |
JET_errInstanceUnavailable |
Windows XP: Questo valore restituito viene introdotto in Windows XP Impossibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede l'accesso a tutti i dati per proteggere l'integrità dei dati. |
JET_errTermInProgress |
Impossibile completare l'operazione perché l'istanza associata alla sessione viene arrestata. |
JET_errRestoreInProgress |
Impossibile completare l'operazione perché è in corso un'operazione di ripristino nell'istanza associata alla sessione. |
JET_errNoBackup |
L'operazione non è riuscita perché non è in corso alcun backup esterno. |
JET_errBackupAbortByServer |
Windows Server 2003: Questo valore restituito viene introdotto in Windows Server 2003. L'operazione non è riuscita perché il backup esterno corrente è stato interrotto da una chiamata a JetStopBackup. |
errBackupAbortByCaller |
Windows XP: Questo valore restituito viene introdotto in Windows XP. Il chiamante ha terminato un backup al centro della sequenza di backup senza segnalare l'intenzione con JetStopBackup. Questo errore è dovuto a un bug nel client di backup in Windows Server 2003 e versioni successive. In Windows XP questo errore viene restituito per una terminazione intenzionale della sequenza di backup esterna. |
JET_errRunningInMultiInstanceMode |
L'operazione non è riuscita perché è stato effettuato un tentativo di utilizzo del motore in modalità legacy (modalità di compatibilità di Windows 2000) in cui è supportata solo un'istanza, se in realtà esistono più istanze. |
Se questa funzione ha esito positivo, il backup esterno ha avuto esito positivo. Operazione riuscita indica che tutti i file (ad esempio, database e log) appropriati per il tipo di backup (specificato in JetBeginExternalBackup) sono stati recuperati dal motore di backup. I file di cui è stato eseguito il backup possono essere recuperati con ripristino rigido (JetExternalRestore).
Se questa funzione ha esito negativo, il backup esterno termina in genere. L'errore indica che il backup non è valido a causa di un errore di utilizzo di un client o di un'applicazione. È importante controllare il codice restituito per questa API per verificare che la sequenza di backup sia stata eseguita correttamente.
Commenti
Se il motore è configurato per registrare gli eventi, viene registrato un evento per indicare la risoluzione del backup esterno.
Se la sequenza di backup non viene completata nell'ordine e con una chiamata riuscita a JetEndExternalBackup, i backup incrementali successivi potrebbero contenere più dati rispetto all'applicazione prevista.
Per altre informazioni sulla sequenza di API di backup esterna, vedere JetBeginExternalBackup.
Prima di Windows Vista, se il troncamento del log non è stato eseguito, il motore ha considerato che il backup è stato un backup di copia. Tuttavia, il backup potrebbe essere un backup normale per il quale non è stato eseguito il troncamento, ad esempio se sono presenti database scollegati. L'opzione JET_bitBackupTruncateDone può essere utilizzata per informare il motore di questa operazione e consentire le modifiche appropriate all'intestazione del database.
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
Parametri di gestione degli errori
Errori del motore di archiviazione estendibile
JetAttachDatabase
JetBeginExternalBackup
JetCloseFile
JET_ERR
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog