Метод 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, а также следующие.

Код возврата Описание
S_OK
 Инициализация выполнена успешно.
S_FALSE
 Обработчик приложения не обрабатывает событие синхронизации.

Комментарии

Значения перечисления 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

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

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems