This method activates an ActiveSync service provider-specific dialog box.
At a Glance
| Header file: | Cesync.h |
| Windows CE versions: | 2.0 and later |
Syntax
HRESULT ActivateDialog( UINT uDlg, HWND hwndParent,
HREPLFLD hFolder, IEnumReplItem * penum );
Parameters
uDlg
Identifies the dialog box to be activated.
hwndParent
Handle to the window that should be used as parent for the dialog box.
hFolder
Handle to a folder.
penum
Pointer to a enumerator of HREPLITEM for objects stored in the folder.
Return Values
One of the values described in the following table is returned.
| Value | Description |
| NOERROR | User selected OK to save the changes made. |
| RERR_CANCEL | User selected CANCEL to ignore the changes made. |
| RERR_SHUT_DOWN | User selected OK to save the changes made. The ActiveSync service manager must be closed now because of these changes. |
| RERR_UNLOAD | User selected OK to save the changes made. Replication modules must be unloaded so the change can take effect. |
| E_NOTIMPL | The requested dialog box is not implemented. |
Remarks
The IReplStore::ActivateDialog method is used to activate dialog boxes options for each object type. ReplDialogs contains the list of dialog boxes that can be activated. An ActiveSync service provider can return E_NOTIMPL if it does not implement a particular dialog box. An enumerator of the HREPLITEM contained in the specified folder is passed in. The ActiveSync service provider should use this enumerator to enumerate all items in the folder.
See Also