ISyncMgrSessionCreator interface (syncmgr.h)

Exposes a single method through which a handler or external application can notify Sync Center that synchronization has begun, as well as report progress and events.

Inheritance

The ISyncMgrSessionCreator interface inherits from the IUnknown interface. ISyncMgrSessionCreator also has these types of members:

Methods

The ISyncMgrSessionCreator interface has these methods.

ISyncMgrSessionCreator::CreateSession Notifies Sync Center that synchronization of the specified items has begun.

Remarks

This interface is passed to the ISyncMgrHandler::Synchronize. The handler can choose to create a session in its Synchronize implementation. This allows the handler to report progress and events itself or to signal a background process to report progress and events itself.

Alternatively, the handler can choose to signal an external process to create a CLSID_SyncMgrClient object. If a handler is implemented to perform automatic synchronizations in an external process such as a service, it must be able to provide progress reports to Sync Center so that Sync Center can update the UI for the user. The handler also must be able to add events to Sync Center's Sync Results folder. An external process creates the CLSID_SyncMgrClient object by passing the CLSCTX_SERVER flag and the ISyncMgrSessionCreator IID to CoCreateInstance. This allows that process to report progress and events as well as to ask Sync Center whether the user canceled the synchronization. Note, however, that ISyncMgrSessionCreator cannot be marshaled to an external process.

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