Microsoft Windows CE 3.0  

CeMountDBVol (RAPI)

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 issues a mount request for a database volume that contains both data and an integrity log. The function returns a CEGUIDthat is the globally unique identifier of a mounted database.

CeMountDBVol (RAPI)is a remote application interface, which enables an application running on a desktop computer to make function calls on a Windows CE–based device.

BOOL CeMountDBVol(
PCEGUID
pceguid
,

LPWSTR
lpszDBVol
,
DWORD
dwFlags
);

Parameters

pceguid
[in/out] Pointer to a buffer that is filled with the CEGUIDof the globally unique identifier of a mounted database.
lpszDBVol
[in] Pointer to the null-terminated string that contains the file name of the database volume to be mounted. The path is limited to MAX_PATH characters and includes the NULL character.
dwFlags
[in] Specifies how the database volume is opened. It is one of the following flags:
Value Description
CREATE_NEW Creates a new database volume. The function fails if the specified database volume already exists.
CREATE_ALWAYS Creates a new database volume. The function overwrites the database volume if it exists.
OPEN_EXISTING Opens the database volume. The function fails if the database volume does not exist.
OPEN_ALWAYS Opens the database volume, if it exists. If the database volume does not exist, the function creates the database volume as if CREATE_NEW was specified.
TRUNCATE_EXISTING Opens the database volume. Once opened, the database volume is truncated so that its size is zero bytes. The function fails if the database volume does not exist.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call CeGetLastError. Possible values for CeGetLastErrorinclude the following:

ERROR_DISK_FULL
The mounted volume does not have space to create the new database.
ERROR_INVALID_PARAMETER
A parameter was invalid.
ERROR_NOT_ENOUGH_MEMORY
There was not enough memory available to create volume.

If the database volume already exists before the function call and dwFlagsis CREATE_ALWAYS or OPEN_ALWAYS, CeGetLastErrorreturns ERROR_ALREADY_EXISTS, even though the function has succeeded.

Remarks

The CeMountDBVol (RAPI)function creates a database volume that contains both data and an integrity log. The function can accept any path including Uniform Naming Convention (UNC) names for files on a LAN.

A single database volume can be mounted more than once by a different application. Each time the volume is mounted, a reference count is incremented. A mounted database volume does not unmount until all applications that mounted the volume call CeUnmountDBVol (RAPI). CeUnmountDBVol (RAPI)must be called to free up system resources.

All data written to a mounted database volume is cached until one of the following occurs: