O'Reilly logo

Palm OS Programming, 2nd Edition by Neil Rhodes, Julie McKeehan

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

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.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required