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 イベントを認識しない場合、アプリケーションはイベントを手動同期として扱う必要があります。

登録されたアプリケーション ハンドラーは、初期化メソッドが初めて呼び出される場合を除き、この呼び出し内でユーザー インターフェイスを表示できません。 アプリケーションは、項目を設定し、ユーザーにアプリケーション機能を導入するために必要な任意の 1 回限りの初期化を表示できます。 同期プロセスの一環として別の理由でユーザー インターフェイスを表示する必要がある場合は、 ISyncMgrSynchronize::P repareForSync メソッドを使用できます。

処理アプリケーションが UpdateItems を使用してプログラムで同期マネージャーを呼び出す場合を除き、lpCookie パラメーターは NULL です。 このシナリオでは、クラス識別子 (CLSID) によって処理アプリケーションが識別され、 lpCookie の値が処理アプリケーションによって渡され、コンテキストの同期中に同期マネージャーによって返されます。 lpCookie パラメーターは、SYNCMGRFLAG_INVOKEが設定されている場合にのみ意味があります。

要件

関連項目

ISyncMgrSynchronize

ISyncMgrSynchronize::P repareForSync

SYNCMGRFLAG

UpdateItems