UltraLite Database User's Guide
Connection Parameters
Database identification parameters
Identifies the Palm card as using the virtual file system.
This parameter is available only in UltraLite for MobileVB. To use the virtual file system from an embedded SQL or static C++ API application, use the EnablePalmFileDB function.
Interface | Connection parameter |
---|---|
UltraLite for MobileVB | VFSOnPalm |
Connection string (UltraLite for MobileVB) | PALM_FS=VFS |
For information about using the connection parameter, see Specifying connection parameters.
As a parameter, VFSOnPalm is a boolean value.
In the connection string, the parameter must be specified as follows:
PALM_FS=VFS
The palm_fs=vfs parameter needs to be specified both for CreateDatabase and OpenConnection if you are using the VFS card for Palm devices and you want the database stored on the card.
To create, drop or connect to a database on a memory card, the following connection parameter must be specified in the parameter string:
Palm_fs=vfs
The default database filename is ul_udb_YYYY.udb, where YYYY is the creator ID of the application. You can control the filename by specifying a different creator ID in the DatabaseOnPalm parameter. For example, the following connection string references a database on the card with filename ul_udb_XXXX.udb:
palm_db=XXXX;palm_fs=vfs
Even when the VSFOnPalm parameter is specified, the palm_db parameter (Database on Palm) must be set to a valid creator ID.
If the VSF On Palm parameter is not specified, the database is created (or dropped from or to which you are connecting) on the device and not the card.