Funzione JetOSSnapshotPrepareInstance

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetOSSnapshotPrepareInstance

La funzione JetOSSnapshotPrepareInstance seleziona un'istanza specifica per far parte della sessione di snapshot.

Windows Vista:JetOSSnapshotPrepareInstance è stato introdotto in Windows Vista.

JET_ERR JET_API JetOSSnapshotPrepareInstance(
  __in          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 è riservato per usi futuri. L'unico valore valido è 0 (zero).

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_errInvalidParameter

Il puntatore id snapshot è NULL o il parametro grbit non è valido.

JET_errOSSnapshotInvalidSequence

Una sessione snapshot è già in corso.

JET_errOSSnapshotInvalidSnapId

L'identificatore per la sessione snapshot non è valido.

Se questa funzione ha esito positivo, l'istanza specificata farà parte della sessione di snapshot.

Se questa funzione ha esito negativo, non si verifica alcuna modifica nello stato del motore.

Commenti

La normale chiamata alla sequenza API è: JetOSSnapshotPrepare, facoltativamente seguita da una o più chiamate a JetOSSnapshotPrepareInstance, quindi da JetOSnapshotFreeze. Dopo l'avvio del blocco, può essere terminato usando JetOSSnapshotThaw. In qualsiasi momento dopo la preparazione, la sessione snapshot può essere terminata bruscamente con JetOSSnapshotAbort. Le voci del registro eventi verranno generate per i diversi passaggi dello snapshot.

Se JetOSSnapshotPrepareInstance non viene chiamato tra l'inizio della sessione (JetOSSnapshotPrepare) e il momento di blocco (JetOSSnapshotFreeze), tutte le istanze in esecuzione nel motore si bloccano e diventano parte della sessione snapshot. Ciò si verifica per due motivi:

  • Semplifica il codice per gli utenti che desiderano tutte le istanze.

  • Consente la compatibilità con le versioni precedenti per i chiamanti delle API snapshot.

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