Palm Programming: The Developer's Guide

Creating, Opening, and Closing Databases

Database management during synchronization is handled completely by the conduit.

Creating a Database

There is a standard database call used by the Sync Manger to create a database:

                  SyncCreateDB(CDbCreateDB& rDbStats)

SyncCreateDB creates a new record or resource database on the handheld and then opens it. You have the same control over database creation from within the conduit that you have on the handheld. The rDbStats parameter is of type CDbCreateDBClass and contains the following important fields:

m_FileHandle

Output field. On a successful return, this contains a handle to the created database with read/write access.

m_Creator

Database creator ID. This should match the creator ID of the application.

m_Flags

The database attributes. Choose one of the following: eRecord for a standard database, eResource for a resource database. Another flag is eBackupDB, which you set for the backup bit.

m_Type

The four-byte database type.

m_CardNo

Memory card where the database is located. Use 0, since no Palm OS device currently has more than one memory card.

m_Name

The database name.

m_Version

The version of the database.

m_dwReserved

Reserved for future use. Must be set to 0.

Opening a Database

The Sync Manager call to open a remote database is:

                  SyncOpenDB(char *pname, int nCardNum, Byte& rHandle, Byte openMode)

The values for the four parameters are:

pName

Name of the database.

nCardNum

Memory card where database is located. Use 0, since no Palm OS ...