Funzione JetOSSnapshotPrepare
Si applica a: Windows | Windows Server
Funzione JetOSSnapshotPrepare
La funzione JetOSSnapshotPrepare inizia i preparativi per una sessione snapshot. Una sessione snapshot è un breve intervallo di tempo in cui il motore non rilascia operazioni di I/O di scrittura su disco, in modo che il motore possa partecipare a una sessione snapshot del volume (se basata su un writer di snapshot).
Windows XP:JetOSSnapshotPrepare è stato introdotto in Windows XP.
JET_ERR JET_API JetOSSnapshotPrepare(
__out JET_OSSNAPID* psnapId,
__in const JET_GRBIT grbit
);
Parametri
psnapId
Identificatore della sessione snapshot da avviare.
grbit
Opzioni per questa chiamata. Questo parametro può avere una combinazione dei valori seguenti.
valore |
Significato |
|---|---|
0 |
Snapshot normale. |
JET_bitIncrementalSnapshot |
Verranno acquisiti solo i file di log. |
JET_bitCopySnapshot |
Snapshot di copia (normale o incrementale) senza troncamento del log. |
JET_bitContinueAfterThaw |
La sessione snapshot si verifica dopo JetOSSnapshotThaw e richiederà una chiamata di funzione JetOSSnapshotEnd . |
JET_bitExplicitPrepare |
Nessuna istanza verrà preparata per impostazione predefinita. Windows 7: JET_bitExplicitPrepare è stato introdotto in Windows 7. |
Valore restituito
Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori E edizione Standard, vedere Extensible Archiviazione Engine Errors and Error Handling Parameters.For more information about the possible E edizione Standard errors, see Extensible Archiviazione Engine Errors and Error Handling Parameters.
Codice restituito |
Descrizione |
|---|---|
JET_errSuccess |
Operazione riuscita. |
JET_errInvalidParameter |
Il puntatore dell'ID snapshot è NULL o il parametro grbit non è valido. |
JET_errOSSnapshotInvalidSequence |
Una sessione snapshot è già in corso e l'operazione non può avere più di una sessione snapshot in un determinato momento. |
Se questa funzione ha esito positivo, una sessione snapshot sarà in grado di iniziare in qualsiasi momento con la fase di blocco di I/O. L'identificatore della sessione verrà restituito e deve essere usato nelle chiamate successive per la sessione snapshot.
Le istanze in esecuzione del motore verranno ora considerate parte della sessione di snapshot.
Windows Vista: per specificare un subset diverso di istanze, è possibile chiamare JetOSSnapshotPrepareInstance .
La normale chiamata di sequenza API è JetOSSnapshotPrepare, seguita facoltativamente da una o più chiamate a JetOSSnapshotPrepareInstance, quindi da JetOSSnapshotFreeze. Una volta avviato il blocco, può essere terminato usando JetOSSnapshotThaw. In qualsiasi momento dopo la preparazione, la sessione snapshot può essere terminata bruscamente con JetOSSnapshotAbort.
Se JET_bitContinueAfterThaw viene specificato dopo JetOSSnapshotThaw, la sessione snapshot rimarrà (anche se l'I/O riprenderà). In questo modo verrà abilitata una verifica dello snapshot e, se necessario, abiliterà il troncamento del log usando JetOSSnapshotTruncateLog e richiederà una chiamata a JetOSSnapshotEnd.
Se questa funzione non riesce, non viene apportata alcuna modifica allo stato del motore.
Osservazioni:
Le voci del registro eventi verranno generate per i diversi passaggi dello snapshot.
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 E edizione Standard NT.lib. |
DLL |
Richiede E edizione Standard NT.dll. |
Vedi anche
JET_ERR
JET_OSSNAPID
JetOSSnapshotAbort
JetOSSnapshotEnd
JetOSSnapshotFreeze
JetOSSnapshotPrepareInstance
JetOSSnapshotThaw
JetOSSnapshotTruncateLog