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 oreResource
for 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 ...
Get Palm OS Programming, 2nd Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.