We told you before that a conduit has three required entry points. There are also some optional ones (including some that are only for CDK 3.0), which we look at next.
The required entry points are as follows:
This returns the conduit’s name.
This function returns the version of the conduit as a four-byte value. The minor version is in the low byte. The major version is in the next byte. The upper two bytes are unused. A conduit with Version 2.1 would return 0x21.
It is from this entry point that the conduit actually does its work. This point passes a parameter that is a class object with information about the sync. The information includes:
Remote database and filename
The type of synchronization to be performed—copy handheld to desktop, copy desktop to PC, fast sync, slow sync, or do nothing
The optional entry points have to do with customization (and File Linking in 3.0):
This is called when the user wants to customize the conduit by pressing Change in the Custom Hotsync dialog (see Figure 11.2). The conduit is responsible for displaying a dialog and saving user choices. A mirror-image synchronization conduit is responsible for displaying the dialog shown in Figure 11.3. The user chooses what action should happen when a sync occurs (unchecking the permanent checkbox in the dialog specifies that the dialog setting ...