JetOSSnapshotThaw Function

Applies to: Windows | Windows Server

The JetOSSnapshotThaw function notifies the engine that it can resume normal IO operations after a freeze period and a successful snapshot.

Windows XP: JetOSSnapshotThaw is introduced in Windows XP.

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

snapId

The identifier of the snapshot session.

grbit

This parameter is reserved for future use and the only valid value supported is 0.

This function returns the JET_ERR datatype with one of the following return codes. For more information about the possible ESE errors, see Extensible Storage Engine Errors and Error Handling Parameters.

Return code	Description
JET_errSuccess	The operation completed successfully.
JET_errInvalidParameter	The snapshot session is invalid or the grbit parameter is invalid.
JET_errOSSnapshotTimeOut	The snapshot session had an internal timeout before this call occurred. Consequently, IO operations returned to normal before this call was made.
JET_errOSSnapshotInvalidSnapId	The identifier for snapshot session is not valid.

If this function succeeds, a snapshot session ends and the normal engine behavior resumes. A new snapshot session can be started later.

If this function fails, the current snapshot session ends but the freeze of IOs during the snapshot period was not respected internally.

Event log entries will be generated for the different steps of the snapshot.

Requirement	Value
Client	Requires Windows Vista or Windows XP.
Server	Requires Windows Server 2008 or Windows Server 2003.
Header	Declared in Esent.h.
Library	Use ESENT.lib.
DLL	Requires ESENT.dll.

Feedback