See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
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::ActiveDialogmust 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::ActivateDialogreturns 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::ActivateDialogreturns 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 phFolderpoints is NULL, the desktop provider must create a new HREPLFLD.