IReplStore::ActivateDialog

The IReplStore::ActivateDialog method activates an ActiveSync service provider-specific dialog box.

Syntax

HRESULT ActivateDialog(
UINT
uDlg,
HWND
hwndParent,
HREPLFLD
hFolder,
IEnumReplItem *
penum
);

At a Glance

Header file: Cesync.h
Platforms: H/PC
Windows CE versions: 2.0 and later

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

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 like 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 given folder is passed in. The ActiveSync service provider should use this enumerator to enumerate all items in the folder.

See Also

IReplStore