Keeping the HotSync Progress Dialog Box Alive
If your conduit does lengthy calculations or operations between calls to the Sync Manager, you will cause the HotSync Progress dialog box to stop functioning: the moving arrows that show progress will stop moving and the Cancel button will no longer work.
The Sync Manager provides a call to make during lengthy operations:
long SyncYieldCycles(WORD wMaxMilliSecs)
This keeps the user interface alive so that you can let the user know
what is happening if necessary. The parameter,
wMaxMilliSecs, is unused: pass 1.
You should call this routine at least every second or so. If you are calling other Sync Manager routines often, you do not need to call this one, as any call to the Sync Manager will keep the Progress dialog box alive.
Tip
Prior to HotSync 3.0, this call was also needed to prevent the communications link between the desktop and the handheld from timing out. This is no longer needed; the communications link won’t be lost even if your conduit is carrying out a lengthy operation.