Palm OS Programming, 2nd Edition

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 Manager to create a database:

long SyncCreateDB(CDbCreateDB& rDbStats)

Like all the Sync Manager routines, SyncCreateDB returns SYNCERR_NONE if no error occurs; otherwise, it returns an error code. 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 the 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 or write access.

m_Creator

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

m_Flags

The database attributes. Choose one of the following: eRecord for a standard database or eResource for a resource database. Another flag within which you can do a bitwise-or is eBackupDB (this sets the backup bit of the database).

m_Type

The 4-byte database type.

m_CardNo

Memory card where the database is located. Use 0, since no Palm OS device has (or will likely have) more than one writable 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 ...