ISyncSession::Start
Starts a synchronization session.
Syntax
HRESULT Start(
CONFLICT_RESOLUTION_POLICY resolutionPolicy,
SYNC_SESSION_STATISTICS * pSyncSessionStatistics);
Parameters
resolutionPolicy
[in] The conflict resolution policy to be used for the synchronization session.pSyncSessionStatistics
[in, out, unique] Returns statistics about the synchronization session.
Return Value
S_OK
E_OUTOFMEMORY
E_INVALIDARG
SYNC_E_INVALID_OPERATION when Start is called more than one time.
SYNC_E_INTERNAL_ERROR
Change applier error codes
Provider-determined error codes
Example
HRESULT Synchronize(ISyncProvider* pProvSrc, ISyncProvider* pProvDest)
{
HRESULT hr = E_UNEXPECTED;
IApplicationSyncServices* pSvc = NULL;
hr = CoCreateInstance(CLSID_SyncServices, NULL, CLSCTX_INPROC_SERVER,
IID_IApplicationSyncServices, (void**)&pSvc);
if (SUCCEEDED(hr))
{
ISyncSession* pSession = NULL;
hr = pSvc->CreateSyncSession(pProvDest, pProvSrc, &pSession);
if (SUCCEEDED(hr))
{
SYNC_SESSION_STATISTICS syncStats;
// Arbitrarily choose "destination wins" conflict resolution.
hr = pSession->Start(CRP_DESTINATION_PROVIDER_WINS, &syncStats);
if (SUCCEEDED(hr))
{
// Display the session statistics to the user.
CString strMsg;
strMsg.Format(L"%d changes succeeded.\n%d changes failed.", syncStats.dwChangesApplied,
syncStats.dwChangesFailed);
MessageBox(NULL, strMsg.GetString(), L"Synchronization Statistics", MB_ICONINFORMATION);
}
pSession->Release();
}
pSvc->Release();
}
return hr;
}