Funzione JetOSSnapshotTruncateLog

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetOSSnapshotTruncateLog

La funzione JetOSSnapshotTruncateLog consente il troncamento del log per tutte le istanze che fanno parte della sessione snapshot.

Windows Vista:JetOSSnapshotTruncateLog è stato introdotto in Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLog(
      __in          const JET_OSSNAPID snapId,
      __in          const JET_GRBIT grbit
    );

Parametri

snapId

Identificatore della sessione snapshot.

grbit

Opzioni per questa chiamata. Questo parametro può avere una combinazione dei valori seguenti.

Valore

Significato

JET_bitAllDatabasesSnapshot

Tutti i database sono collegati in modo che il motore di archiviazione possa calcolare ed eseguire il troncamento del log.

0 (zero)

Non si verificherà alcun troncamento.

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_errInvalidGrbit

Il parametro grbit non è valido.

JET_errOSSnapshotInvalidSequence

La sessione snapshot non è nello stato in cui può verificarsi un troncamento. Le cause possibili sono:

  • la chiamata viene eseguita dopo il timeout della sessione snapshot

  • la sessione è stata specificata come snapshot di copia

In caso di esito positivo, i file di log per una o tutte le istanze della sessione snapshot verranno troncati, se possibile.

Commenti

Questa funzione deve essere chiamata solo se lo snapshot è stato creato con l'opzione JET_bitContinueAfterThaw. In caso contrario, la sessione snapshot sarebbe terminata dopo la chiamata jetOSSnapshotThaw .

Requisiti

Requisito Valore

Client

Richiede Windows Vista.

Server

Richiede Windows Server 2008.

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
JET_ERR
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw