CeMountDBVol (EDB) (Windows CE 5.0)
This function is used to mount a volume. Although this function may be used to mount an EDB volume, applications should call CeMountDBVolEx (EDB) when mounting an EDB volume.
BOOLCeMountDBVol(PCEGUIDpceguid,LPWSTRlpszDBVol,DWORDdwFlags);
Parameters
- pceguid
[out] Pointer to a buffer that is filled in with the CEGUID value of 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] Specification for opening the database volume. The following table shows the possible values for dwFlags.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 Deletes all data on the volume, including databases and records, and resets the volume locale identifier (LCID). This has the same result as calling DeleteFile on a volume and then calling CeMountDBVol (EDB) with the CREATE_NEW flag set. The specified volume must not be mounted by an application, or an access denied error will occur. EDB_MOUNT_FLAG When set, indicates that an EDB database mount is occurring. When this flag is set, CeMountDbVol has the same effect as CeMountDBVolEx with a NULL pOptions parameter.
Return Values
TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError). The following table lists the possible values for GetLastError.
| Value | Description |
|---|---|
| ERROR_DISK_FULL | Returned if the mounted volume does not have space to create the new database. |
| ERROR_PATH_NOT_FOUND | Returned if the specified path was not found. |
| ERROR_NOT_ENOUGH_MEMORY | Returned if there was not enough memory available to create the volume. If the database volume already exists before the function call and dwFlags is set to CREATE_ALWAYS or OPEN_ALWAYS, GetLastError returns ERROR_ALREADY_EXISTS, even through the function has succeeded. |
| ERROR_ACCESS_DENIED | Returned if dwFlags is set to CREATE_ALWAYS or TRUNCATE_EXISTING. and a database volume with the given name is currently mounted by an application. This error is also returned if the file name refers to a file that is not a valid database volume. |
| ERROR_ALREADY_EXISTS | Returned if dwFlags is set to CREATE_NEW and a database volume with the given name already exists. This error is also returned if a database volume is already mounted with the same CEGUID value as the new volume that is being mounted. |
Remarks
When you use the CeMountDBVol function to mount an EDB volume, this function calls the CeMountDbVolEx function, passing a value of NULL for the pOptions parameter.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: Windbase.h.
Link Library: Coredll.lib.
See Also
CeMountDBVolEx (EDB) | CeMountDBVol
Send Feedback on this topic to the authors