ISyncMgrControl interface (syncmgr.h)
Exposes methods that allow an application or handler to start or stop a synchronization, notify Sync Center of changes to the set of handlers or items, or notify of changes to property values.
Inheritance
The ISyncMgrControl interface inherits from the IUnknown interface. ISyncMgrControl also has these types of members:
Methods
The ISyncMgrControl interface has these methods.
| ISyncMgrControl::ActivateHandler Activates or deactivates a handler. |
| ISyncMgrControl::EnableHandler Enables or disables a handler. |
| ISyncMgrControl::EnableItem Enables or disables a sync item managed by a specified handler. |
| ISyncMgrControl::StartHandlerSync Initiates the synchronization of all items managed by a particular handler. |
| ISyncMgrControl::StartItemSync Initiates the synchronization of specified items managed by a particular handler. |
| ISyncMgrControl::StartSyncAll Synchronizes all items managed by all handlers. |
| ISyncMgrControl::StopHandlerSync Stops the synchronization of a specified handler. |
| ISyncMgrControl::StopItemSync Stops the synchronization of specified items managed by a particular handler. |
| ISyncMgrControl::StopSyncAll Stops the synchronization of all items managed by all handlers. |
| ISyncMgrControl::UpdateConflicts Informs Sync Center that conflicts have been added for a specific handler or item. |
| ISyncMgrControl::UpdateEvents Informs Sync Center that events have been added for a specific handler or item. |
| ISyncMgrControl::UpdateHandler Instructs Sync Center to reenumerate the items managed by a handler or informs it that properties of the handler have changed. |
| ISyncMgrControl::UpdateHandlerCollection Instructs Sync Center to reenumerate the handler collection, or informs it that properties of a handler in the handler collection have changed. |
| ISyncMgrControl::UpdateItem Informs Sync Center that properties of a sync item have changed. |
Remarks
ISyncMgrControl is implemented by Sync Center. It can be instantiated by an application or handler as the CLSID_SyncMgrControl object, which is implemented as a Component Object Model (COM) local server. As a result, calls to ISyncMgrControl methods could take considerable time. Those calls should not be made on a UI thread.
All methods of this interface queue their requests with Sync Center.
ISyncMgrControl is a replacement for ISyncMgrSynchronizeInvoke.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | syncmgr.h |