Funzione JetEndExternalBackupInstance2

Si applica a: Windows | Windows Server

Funzione JetEndExternalBackupInstance2

La funzione JetEndExternalBackupInstance2 termina una sessione di backup esterna. Questa API è l'ultima API in una serie di API che devono essere chiamate per eseguire un backup online (non basato su VSS).

Windows XP: JetEndExternalBackupInstance2 viene introdotto in Windows XP.

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

Parametri

Istanza

Istanza da usare per questa chiamata.

Windows 2000: 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.

Windows XP: Per windows XP e versioni successive, 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

Gruppo di bit che specifica zero o più delle opzioni seguenti.

Valore	Significato
JET_bitBackupEndAbort 0x0002	L'applicazione client interrompe il backup.
JET_bitBackupEndNormal 0x0001	L'applicazione client ha completato completamente il backup e termina normalmente.
JET_bitBackupTruncateDone 0x0100	Windows Vista: JET_bitBackupTruncateDone viene introdotto in Windows Vista. Il motore può contrassegnare le intestazioni del database come appropriato (ad esempio, un backup completo completato), anche se la chiamata a troncamento non è stata completata.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sugli errori ESE possibili, vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_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_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.
JET_errClientRequestToStopJetService	L'operazione non può essere completata perché tutte le attività nell'istanza associata alla sessione hanno interrotto come risultato 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 che l'accesso a tutti i dati venga revocato per proteggere l'integrità dei dati.
JET_errNoBackup	L'operazione non è riuscita perché non è in corso alcun backup esterno.
JET_errNotInitialized	L'operazione non può essere completata perché l'istanza associata alla sessione non è ancora stata inizializzata.
JET_errRestoreInProgress	L'operazione non può essere completata perché un'operazione di ripristino è in corso nell'istanza associata alla sessione.
JET_errRunningInMultiInstanceMode	L'operazione non è riuscita perché è stato effettuato un tentativo di usare il motore in modalità legacy (modalità di compatibilità di Windows 2000) in cui è supportata solo un'istanza, quando in realtà esistono più istanze.
JET_errTermInProgress	Impossibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.

Se la funzione ha esito positivo, il backup esterno ha avuto esito positivo. L'esito positivo indica che tutti i file,ad esempio i database e i log, appropriati per il tipo di backup (specificato in JetBeginExternalBackup) sono stati recuperati dal motore di backup. I file di backup possono essere recuperati con ripristino rigido (JetExternalRestore).

Se questa funzione ha esito negativo, il backup esterno termina in genere. Errore indica che il backup non è valido a causa di un client o di un errore di utilizzo dell'applicazione. È importante controllare il codice restituito per questa API per verificare che la sequenza di backup sia riuscita.

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 in 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 fatto, il motore ha considerato che il backup era 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 usata per informare il motore su questo e consentire modifiche appropriate all'intestazione del database.

Requisiti

Requisito	Valore
Client	Richiede Windows Vista o Windows XP.
Server	Richiede Windows Server 2008 o Windows Server 2003.
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 estendibili
JET_ERR
JET_GRBIT
JetAttachDatabase
JetBeginExternalBackup
JetBeginExternalBackupInstance
JetCloseFile
JetExternalRestore
JetGetAttachInfo
JetGetLogInfo
JET_INSTANCE
JetOpenFile
JetReadFile
JetStopBackup
JetStopService
JetTruncateLog