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.
A version of this page is also available for
4/8/2010

This method activates an ActiveSync service provider–specific dialog box.

Syntax 

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

Parameters

uDlg

[in] Identifies the dialog box to be activated.

hwndParent

[in] Handle to the window that should be used as parent for the dialog box.

hFolder

[in] Handle to a folder.

penum

[in] Pointer to a enumerator of HREPLITEMfor objects stored in the folder.

Return Value

The following table shows the possible return values for this method.

Value Description

NOERROR

User selected OKto save the changes made.

RERR_CANCEL

User selected CANCELto ignore the changes made.

RERR_SHUT_DOWN

User selected OKto save the changes made. The ActiveSync manager must be closed now because of these changes.

E_NOTIMPL

The requested dialog box is not implemented.

Remarks

ActivateDialogactivates dialog box options for each object type. The ReplDialogsenumeration in Cesync.h 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 HREPLITEMcontained in the specified folder is passed in. The ActiveSync service provider should use this enumerator to enumerate all items in the folder.

Requirements

Header cesync.h
Library coredll.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IReplStore
HREPLITEM