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:
eRecordfor a standard database oreResourcefor a resource database. Another flag within which you can do a bitwise-or iseBackupDB(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 ...