Funzione JetTruncateLogInstance

Si applica a: Windows | Windows Server

Funzione JetTruncateLogInstance

La funzione JetTruncateLogInstance viene usata durante un backup avviato da JetBeginExternalBackup per eliminare tutti i file di log delle transazioni che non saranno più necessari dopo il completamento del backup corrente.

Windows XP:JetTruncateLogInstance viene introdotto in Windows XP.

    JET_ERR JET_API JetTruncateLogInstance(
      __in          JET_INSTANCE instance
    );

Parametri

Istanza

Istanza 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 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.

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_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	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. Questo errore verrà restituito solo da Windows XP e versioni successive.
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 contiene un valore imprevisto o la combinazione di diversi parametri ha restituito un risultato imprevisto. Ciò può verificarsi per JetTruncateLog quando l'handle di istanza specificato non è valido.
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 esistono già 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 dopo l'eliminazione del backup corrente. Il computer con stato di backup sarà avanzato in modo che il backup dei file di database non sia più consentito. È possibile aprire solo i file di patch del database e i file di log delle transazioni per il backup oltre questo punto.

Se questa funzione ha esito negativo, il computer dello stato di backup può essere avanzato in modo che il backup dei file di database non sia più consentito. Un certo numero di file di log delle transazioni potrebbe essere eliminato che è minore del numero desiderato, ma verranno sempre eliminati dal più vecchio al più giovane.

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

File del motore di archiviazione estendibili
JET_ERR
JET_INSTANCE
JetBeginExternalBackup
JetOpenFile
JetStopBackup
JetStopService