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

Статья
08/24/2023

Позволяет зарегистрированному приложению отображать любой пользовательский интерфейс и выполнять любую необходимую инициализацию перед вызовом метода ISyncMgrSynchronize::Synchronize . Например, приложению, такому как почтовый клиент Microsoft Outlook, может потребоваться отобразить диалоговое окно пароля, чтобы пользователь мог войти на почтовый сервер.

Синтаксис

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

Параметры

[in] cbNumItems

Тип: ULONG

Количество элементов в массиве, на который указывают идентификаторы pItemID.

[in] pItemIDs

Тип: GUID*

Массив идентификаторов элементов, которые пользователь выбирает для синхронизации.

[in] hWndParent

Тип: HWND

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

[in] dwReserved

Тип: DWORD

Зарезервировано. Зарегистрированные приложения должны игнорировать это значение.

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

Тип: HRESULT

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

Код возврата	Описание
S_OK	Подготовка прошла успешно.

Зарегистрированный обработчик приложения должен возвращать данные из этого метода как можно скорее, а затем вызывать метод PrepareForSyncCompleted . Зарегистрированный обработчик приложения может вызвать метод PrepareForSyncCompleted перед возвратом из этого метода.

Зарегистрированные приложения должны отображать пользовательский интерфейс, только если флаг SYNCMGRFLAG_MAYBOTHERUSER установлен в параметре dwSyncFlags метода ISyncMgrSynchronize::Initialize . Если зарегистрированное приложение не может подготовиться к синхронизации без отображения пользовательского интерфейса, если флаг SYNCMGRFLAG_MAYBOTHERUSER не установлен, оно должно вернуть S_FALSE из этого метода.

Массив идентификаторов элементов, передаваемых в этот метод, также относится к методу ISyncMgrSynchronize::Synchronize .

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

Требования


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