This function flushes information from a database volume to permanent storage.
At a Glance
Header file: | Windbase.h |
Windows CE versions: | 2.10 and later |
Syntax
BOOL CeFlushDBVol( PCEGUID pceguid );
Parameters
pceguid
[in] Pointer to the CEGUID that contains the globally unique identifier of a mounted volume to be flushed.
Return Values
TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.
Remarks
In a mounted database volume, all write operations are cached. To explicitly force the data to be written out to permanent storage, the CeFlushDBVol function must be called. If a reset or power failure occurs before data is flushed from the cache, then the data that has not been flushed is lost. The database engine periodically flushes the database volume when enough data has been changed, but an application that must be assured that their data is saved should call CeFlushDBVol. A database volume is also flushed when it is unmounted.
See Also