Share via


CeFlushDBVol (CEDB) (Windows CE 5.0)

Send Feedback

This function flushes information from a database volume to permanent storage.

This function does not work with EDB databases. For more information on EDB, see EDB Functions.

BOOL CeFlushDBVol( PCEGUID pceguid); 

Parameters

  • pceguid
    [in] Pointer to the CEGUID that contains the globally unique identifier (GUID) of a mounted volume to be flushed. If this parameter is set to NULL, all database volumes that have been mounted will 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 its data is saved should call CeFlushDBVol. A database volume is also flushed when it is unmounted.

It is not necessary to call CeFlushDBVol on the object store. Data written to the object store is not cached and will persist as long as the object store persists.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Windbase.h.
Link Library: Coredll.lib.

See Also

CeUnmountDBVol (CEDB) | CeWriteRecordProps (CEDB)

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.