Метод ISyncMgrSynchronize::Synchronize (mobsync.h)

Вызывается диспетчером синхронизации один раз для каждой выбранной группы после того, как пользователь выбрал зарегистрированные приложения для синхронизации.

Синтаксис

HRESULT Synchronize(
  [in] HWND hWndParent
);

Параметры

[in] hWndParent

Тип: HWND

Дескриптор родительского HWND зарегистрированного приложения должен использоваться для всех отображаемых в нем элементов пользовательского интерфейса. Это значение может иметь значение NULL.

Возвращаемое значение

Тип: HRESULT

Этот метод поддерживает стандартные возвращаемые значения, E_INVALIDARG, E_UNEXPECTED и E_OUTOFMEMORY, а также следующие:

Код возврата Описание
S_OK
Синхронизация прошла успешно.
E_FAIL
Сбой синхронизации.

Комментарии

Если пользователь не выбирает варианты элементов для зарегистрированного приложения, метод ISyncMgrSynchronize::Synchronize не вызывается и интерфейс освобождается. Если этот метод вызывается, приложение должно синхронизировать элементы, указанные в методе ISyncMgrSynchronize::P repareForSync .

Обработчик зарегистрированного приложения должен вернуться из метода ISyncMgrSynchronize::Synchronize как можно скорее, а затем вызвать метод SynchronizeCompleted . Обработчик может вызвать вызов SynchronizeCompleted перед возвратом из метода ISyncMgrSynchronize::Synchronize .

Приложение должно дать отзыв о ходе выполнения и проверить, следует ли отменить синхронизацию с помощью указателя интерфейса pSyncCallBack , настроенного в методе ISyncMgrSynchronize::SetProgressCallback .

Приложения должны предоставлять сведения о ходе выполнения, даже если флаг SYNCMGRFLAG_MAYBOTHERUSER не указан в ISyncMgrSynchronize::Initialize.

Приложения должны стараться не показывать элементы пользовательского интерфейса из метода ISyncMgrSynchronize::Synchronize . Все элементы пользовательского интерфейса должны отображаться в методах ISyncMgrSynchronize::P repareForSync и ISyncMgrSynchronize::ShowError , чтобы конечный пользователь пользовался согласованным пользовательским интерфейсом, который ограничен входом и указанием общих папок для синхронизации. Впоследствии синхронизацию можно выполнить без вмешательства пользователя. После завершения синхронизации могут отображаться конфликты или другие сообщения об ошибках.

Методы ISyncMgrSynchronizeCallback можно вызывать в любом потоке в приложении.

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mobsync.h
DLL Mobsync.dll

См. также раздел

ISyncMgrSynchronize

ISyncMgrSynchronize::Initialize

ISyncMgrSynchronize::P repareForSync

ISyncMgrSynchronize::SetProgressCallback

ISyncMgrSynchronize::ShowError

SynchronizeCompleted