Last modified: January 09, 2012
Applies to: Windows | Windows Server
The JetIdle function is defunct, and should only be used for testing purposes. JetIdle can be used to perform idle cleanup tasks or check the version store status in ESE.
JET_ERR JET_API JetIdle( __in JET_SESID sesid, __in JET_GRBIT grbit );
The session that will be used for this call.
A group of bits that contain the options to be used for this call, which include zero or more of the following bits:
Triggers cleanup of the version store.
Reserved for future use. If this flag is specified, the API will return JET_errInvalidgrbit.
Returns JET_wrnIdleFull if version store is more than half full.
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.
The operation completed successfully.
A grbit parameter that was provided to the API was not valid.
If this function succeeds, the appropriate operation will be triggered, or an error code indicating how full the version store is depending on the grbit provided.
If this function fails, the requested operation will not have completed successfully.
The version store maintains ESE's snapshot isolation mechanism. If the version store is more than half full, the program might close long-running transactions. If a long-running transaction exhausts the version store, ESE will stop allowing write operations to the database.
Requires Windows Vista, Windows XP, or Windows 2000 Professional.
Requires Windows Server 2008, Windows Server 2003, or Windows 2000 Server.
Declared in Esent.h.