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 iseBackupDB
, 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 ...
Get Palm Programming: The Developer's Guide 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.