ISyncMgrSynchronize::P repareForSync 方法 (mobsync.h)

允許已註冊的應用程式顯示任何使用者介面,並在呼叫 ISyncMgrSynchronize::Synchronize 方法之前執行任何必要的初始化。 例如,Microsoft Outlook 電子郵件用戶端之類的應用程式可能需要顯示密碼對話方塊,讓使用者能夠登入郵件伺服器。

語法

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

參數

[in] cbNumItems

類型: ULONG

pItemIDs所指向之陣列中的專案數。

[in] pItemIDs

類型: GUID*

使用者選擇同步處理的專案識別碼陣列。

[in] hWndParent

類型: HWND

HWND 的控制碼,已註冊的應用程式應該用於任何顯示的使用者介面專案。 此值可以是 Null

[in] dwReserved

類型: DWORD

保留的。 已註冊的應用程式應該忽略此值。

傳回值

類型: HRESULT

此方法支援標準傳回值E_INVALIDARG、E_UNEXPECTED和E_OUTOFMEMORY,以及下列專案:

傳回碼 描述
S_OK
準備成功。

備註

已註冊的應用程式處理常式應該儘快從這個方法傳回,然後呼叫 PrepareForSyncCompleted 方法。 已註冊的應用程式處理常式可以在從此方法傳回之前呼叫 PrepareForSyncCompleted 方法。

如果已在ISyncMgrSynchronize::Initialize方法的dwSyncFlags參數中設定SYNCMGRFLAG_MAYBOTHERUSER旗標,則已註冊的應用程式應該只會顯示使用者介面。 如果已註冊的應用程式在未設定 SYNCMGRFLAG_MAYBOTHERUSER 旗標時無法準備同步處理,則應該從此方法傳回S_FALSE。

傳遞給這個方法的專案識別碼陣列也與 ISyncMgrSynchronize::Synchronize 方法相關。

您可以在已註冊的應用程式的任何執行緒上呼叫 ISyncMgrSynchronizeCallback 方法。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mobsync.h
Dll Mobsync.dll

另請參閱

ISyncMgrSynchronize

ISyncMgrSynchronize::Initialize

ISyncMgrSynchronize::Synchronize

ISyncMgrSynchronizeCallback

PrepareForSyncCompleted

SYNCMGRFLAG