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,以及下列專案:
傳回碼 | 描述 |
---|---|
|
準備成功。 |
備註
已註冊的應用程式處理常式應該儘快從這個方法傳回,然後呼叫 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::Initialize