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 方法。
除非處理應用程式使用UpdateItems以程式設計方式叫用同步處理管理員,否則lpCookie參數為Null。 在此案例中,類別識別碼 (CLSID) 識別處理應用程式,而處理應用程式會傳入 lpCookie 的值,然後在同步處理期間由同步處理管理員傳回內容。 只有在設定SYNCMGRFLAG_INVOKE時,lpCookie參數才有意義。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | mobsync.h |
Dll | Mobsync.dll |