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

Статья
03/15/2023

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

Синтаксис

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