Condividi tramite

Funzione JetOSSnapshotTruncateLogInstance

Si applica a: Windows | Windows Server

Funzione JetOSSnapshotTruncateLogInstance

La funzione JetOSSnapshotTruncateLogInstance tronca il log per un'istanza specificata durante una sessione snapshot.

Windows Vista:JetOSSnapshotTruncateLogInstance viene introdotto in Windows Vista.

    JET_ERR JET_API JetOSSnapshotTruncateLogInstance(
      __in          const JET_OSSNAPID snapId,
      __in          JET_INSTANCE instance,
      __in          const JET_GRBIT grbit
    );

Parametri

snapId

Identificatore della sessione snapshot.

Istanza

Istanza che verrà usata per questa chiamata.

grbit

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

grbit può essere uno dei valori seguenti:

Valore

Significato

JET_bitAllDatabasesSnapshot

Tutti i database vengono collegati in modo che il motore di archiviazione possa calcolare e 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 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_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 completata dopo il timeout della sessione snapshot.

  • La sessione è stata specificata come snapshot di copia.

Se questa funzione ha esito positivo, i file di log per una o tutte le istanze che fanno parte 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 termina dopo la chiamata a 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 estendibili
JET_ERR
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepare
JetOSSnapshotThaw

  • Last updated on