CeFlushDBVol

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

BOOL CeFlushDBVol(
PCEGUID
pceguid
);

Parameters

pceguid

[in] Pointer to the CEGUIDthat 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 CeFlushDBVolfunction 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.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	2.10 and later	Windbase.h	Winbase.h	Fsdbase.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.