ISyncMgrSynchronize interface

Exposes methods that enable the registered application or service to receive notifications from the synchronization manager.

Members

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

Methods

The ISyncMgrSynchronize interface has these methods.

MethodDescription
EnumSyncMgrItems

Obtains the ISyncMgrEnumItems interface for the items that are handled by a registered application.

GetHandlerInfo

Obtains handler information.

GetItemObject

Obtains an interface on a specified item that a registered application handles.

Initialize

Called by the synchronization manager in a registered application handler to determine whether the handler processes the synchronization event.

PrepareForSync

Allows a registered application to display any user interface, and perform any necessary initialization before the ISyncMgrSynchronize::Synchronize method is called. For example, an application such as the Outlook email client may need to display the password dialog box to enable a user to log on to a mail server.

SetItemStatus

Called by the synchronization manager in a registered application's handler to change the status of an item in the following two cases: between the time the handler has returned from the ISyncMgrSynchronize::PrepareForSync method and called the ISyncMgrSynchronizeCallback::PrepareForSyncCompleted callback method, or after the handler has returned from the ISyncMgrSynchronize::Synchronize method but has not yet called the ISyncMgrSynchronizeCallback::SynchronizeCompleted callback method.

SetProgressCallback

Sets the ISyncMgrSynchronizeCallback interface. Registered applications use this callback interface to give status information from within the ISyncMgrSynchronize::PrepareForSync and ISyncMgrSynchronize::Synchronize methods.

ShowError

Called by the synchronization manager in a registered application handler when a user double-clicks an associated message in the error tab.

ShowProperties

Called by the synchronization manager when a user selects an item in the choice dialog box, and then clicks the Properties button.

Synchronize

Called by the synchronization manager once for each selected group after the user has chosen the registered applications to be synchronized.

 

Remarks

When to Implement

This interface should be implemented on the registered application's handler to receive notifications from the synchronization manager and to participate in the synchronization process.

ISyncMgrSynchronize has been replaced in Windows Vista by ISyncMgrHandler.

When to Use

The synchronization manager calls the methods of this interface to send notifications to the registered application or service during synchronization.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Mobsync.h

DLL

Mobsync.dll

See also

ISyncMgrEnumItems
ISyncMgrSynchronizeCallback
ISyncMgrSynchronizeInvoke

 

 

Community Additions

ADD
Show:
© 2014 Microsoft