Setting Synchronization Options
A version of this page is also available for
4/8/2010
There is no built-in function for setting synchronization options. The desktop provider must supply a user interface that allows user to choose options. The user interface has no particular requirements or limitations.
A user accesses the user interface by invoking the settings of the service provider in the desktop ActiveSync user interface. The service manager then calls IReplStore::ActivateDialog, which displays the user interface for that service provider. If the desktop provider does not support a synchronization options dialog box, the call to IReplStore::ActiveDialog must return E_NOTIMPL. To get a handle to a parent window to display a dialog box or message box, have the desktop provider call IReplNotify::GetWindow.
If IReplStore::ActivateDialog returns RERR_UNLOAD, ActiveSync sets the provider in an error state and does not proceed with synchronization until the user disconnects and reconnects the service. If the user cancels the sync options dialog box, IReplStore::ActivateDialog returns RERR_CANCEL.
You can save synchronization options for the desktop provider either in the registry or in the HREPLFLD handle. If you save synchronization options in a HREPLFLD handle, the desktop provider sets default option values in IReplStore::GetFolderInfo. If the pointer to which phFolder points is NULL, the desktop provider must create a new HREPLFLD.