ISyncMgrSynchronize::Synchronize method

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

Syntax


HRESULT Synchronize(
  [in] HWND hWndParent
);

Parameters

hWndParent [in]

Type: HWND

A handle to the parent HWND the registered application should use for any user interface elements that it displays. This value may be NULL.

Return value

Type: HRESULT

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

Return codeDescription
S_OK

Synchronization was successful.

E_FAIL

Synchronization failed.

 

Remarks

If the user does not select any item choices for the registered application, the ISyncMgrSynchronize::Synchronize method is not called and the interface is released. If this method is called, the application must synchronize the items that were specified in the ISyncMgrSynchronize::PrepareForSync method.

The registered application's handler should return from the ISyncMgrSynchronize::Synchronize method as soon as possible and then call the SynchronizeCompleted method. It is acceptable for the handler to call the SynchronizeCompleted call before returning from the ISyncMgrSynchronize::Synchronize method.

The application must give progress feedback and check whether the synchronization should be canceled by using the pSyncCallBack interface pointer that was set up in the ISyncMgrSynchronize::SetProgressCallback method.

Applications must provide progress information even if the SYNCMGRFLAG_MAYBOTHERUSER flag was not specified in ISyncMgrSynchronize::Initialize.

Applications should try not to show user interface elements from within the ISyncMgrSynchronize::Synchronize method. Any user interface elements should be shown in the ISyncMgrSynchronize::PrepareForSync and ISyncMgrSynchronize::ShowError methods so the end user experiences a consistent user interface which is limited to logon and to specifying shares to be synchronized. Subsequently, the synchronization can be performed without any user intervention. After the synchronization is complete, conflicts or other error messages can be shown.

The ISyncMgrSynchronizeCallback methods can be called on any thread in your application.

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

ISyncMgrSynchronize
ISyncMgrSynchronize::Initialize
ISyncMgrSynchronize::PrepareForSync
ISyncMgrSynchronize::SetProgressCallback
ISyncMgrSynchronize::ShowError
SynchronizeCompleted

 

 

Show: