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 方法。

除非處理應用程式使用UpdateItems以程式設計方式叫用同步處理管理員，否則lpCookie參數為Null。 在此案例中，類別識別碼 (CLSID) 識別處理應用程式，而處理應用程式會傳入 lpCookie 的值，然後在同步處理期間由同步處理管理員傳回內容。 只有在設定SYNCMGRFLAG_INVOKE時，lpCookie參數才有意義。

需求

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

另請參閱

ISyncMgrSynchronize

ISyncMgrSynchronize：:P repareForSync

SYNCMGRFLAG

UpdateItems