ISyncMgrSynchronize::ShowProperties

The ISyncMgrSynchronize::ShowProperties method is called by the Synchronization Manager when the user selects an item in the choice dialog box and clicks the properties button.

HRESULT ShowProperties(
  HWND hWndParent,           // Parent hwnd for any dialog displayed
  REFSYNCMGRITEMID ItemID    // Specifies item requested
);

Parameters

hWndParent

[in] Specifies the parent hWnd for any user interface the registered application displays to set properties. This value may be NULL.

ItemID

[in] Identifies the item for which properties are requested.

Return Values

This method supports the standard return values, E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following:

S_OK

Properties dialog for this item was handled properly.

Remarks

If a registered application provides a properties dialog box for an item, it must set the SYNCMGRITEM_HASPROPERTIES bit in the dwFlags member of the SYNCMGRITEM structure.

If ItemID is GUID_NULL the handler should show the Properties dialog for the overall handler.

The appearance of the displayed dialog box should be consistent with a standard Property Page dialog box.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with Internet Explorer 5 or later).
  Windows 95/98: Requires Windows 95 or later (with Internet Explorer 5 or later).
  Header: Declared in Mobsync.h.

See Also

SYNCMGRITEM, SYNCMGRITEMFLAGS