Funzione JetTruncateLog
Si applica a: Windows | Windows Server
Funzione JetTruncateLog
La funzione JetTruncateLog viene usata durante un backup avviato da JetBeginExternalBackup per eliminare tutti i file di log delle transazioni che non saranno più necessari al termine del backup corrente.
JET_ERR JET_API JetTruncateLog(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_errBackupAbortByServer |
L'operazione non è riuscita perché il backup esterno corrente è stato interrotto da una chiamata a JetStopBackup. Windows Server 2003: Questo valore restituito viene introdotto in Windows Server 2003. |
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 |
Impossibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede la revoca dell'accesso a tutti i dati per proteggere l'integrità dei dati. Windows XP: Questo valore restituito viene introdotto in Windows XP. |
JET_errInvalidBackupSequence |
L'operazione di backup non è riuscita perché è stata chiamata fuori sequenza. JetTruncateLog restituirà questo errore se sono presenti handle di file in sospeso creati usando JetOpenFile per l'istanza. |
JET_errInvalidParameter |
Uno dei parametri forniti conteneva un valore imprevisto o la combinazione di diversi parametri ha restituito un risultato imprevisto. Questa situazione può verificarsi per JetTruncateLog quando l'handle di istanza specificato non è valido. Windows XP: Questo valore restituito viene introdotto in Windows XP. |
JET_errNoBackup |
L'operazione non è riuscita perché non è in corso alcun backup esterno. |
JET_errNotInitialized |
Impossibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata. |
JET_errRestoreInProgress |
Impossibile completare l'operazione perché è in corso un'operazione di ripristino nell'istanza associata alla sessione. |
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. |
JET_errTermInProgress |
Impossibile completare l'operazione perché l'istanza associata alla sessione viene arrestata. |
Se questa funzione ha esito positivo, il set di file di log delle transazioni che non saranno più necessari al termine del backup corrente viene eliminato correttamente. La macchina a stati di backup sarà avanzata in modo che il backup dei file di database non sia più consentito. Solo i file di patch del database e i file di log delle transazioni possono essere aperti per il backup oltre questo punto.
Se questa funzione ha esito negativo, la macchina a stati di backup può essere avanzata in modo che il backup dei file di database non sia più consentito. È possibile eliminare un numero di file di log delle transazioni minore del numero desiderato, ma verranno sempre eliminati dal più vecchio al più giovane.
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
File del motore di archiviazione estendibile
JetBeginExternalBackup
JET_ERR
JET_INSTANCE
JetOpenFile
JetStopBackup
JetStopService