Метод ISyncMgrSynchronize::Initialize (mobsync.h)
Вызывается диспетчером синхронизации в зарегистрированном обработчике приложения, чтобы определить, обрабатывает ли обработчик событие синхронизации.
Синтаксис
HRESULT Initialize(
[in] DWORD dwReserved,
[in] DWORD dwSyncMgrFlags,
[in] DWORD cbCookie,
[in] const BYTE *lpCookie
);
Параметры
[in] dwReserved
Тип: DWORD
Защищены; значение должно быть равно 0 (ноль).
[in] dwSyncMgrFlags
Тип: DWORD
Значения перечисления SYNCMGRFLAG , описывающие, как инициируется событие синхронизации.
[in] cbCookie
Тип: DWORD
Размер данных lpCookie в байтах.
[in] lpCookie
Тип: BYTE const*
Указатель на маркер, идентифицирующий приложение. Этот маркер передается, когда приложение вызывает диспетчер синхронизации программным способом.
Возвращаемое значение
Тип: HRESULT
Этот метод поддерживает стандартные возвращаемые значения E_INVALIDARG, E_UNEXPECTED и E_OUTOFMEMORY, а также следующие.
| Код возврата | Описание |
|---|---|
|
Инициализация выполнена успешно. |
|
Обработчик приложения не обрабатывает событие синхронизации. |
Комментарии
Значения перечисления SYNCMGRFLAG применяются на протяжении всего времени существования интерфейса ISyncMgrSynchronize и используются другими методами ISyncMgrSynchronize .
Если приложение не распознает событие SYNCMGRFLAG , оно должно рассматривать его как синхронизацию вручную.
Зарегистрированный обработчик приложения не может отображать пользовательский интерфейс в этом вызове, если только не вызывается метод инициализации в первый раз. Приложение может отображать любую разовую инициализацию, необходимую для настройки элементов и ознакомления пользователя с функцией приложения. Если необходимо отобразить пользовательский интерфейс по другой причине в процессе синхронизации, можно использовать метод ISyncMgrSynchronize::P repareForSync .
Параметр lpCookie имеет значение NULL , если приложение обработки не вызывает диспетчер синхронизации программным способом с помощью UpdateItems. В этом сценарии идентификатор класса (CLSID) идентифицирует приложение обработки, и значение lpCookie передается приложением обработки, а затем передается обратно диспетчером синхронизации во время синхронизации для контекста. Параметр lpCookie имеет смысл только в том случае, если задано SYNCMGRFLAG_INVOKE .
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | mobsync.h |
| DLL | Mobsync.dll |