プログラムからの同期マネージャーの使用

アプリケーションで同期マネージャーを使用できるようにするには、受け取ったりから受信する同期通知を処理するためのコンポーネントオブジェクトモデル (COM) オブジェクトを実装する必要があります。 アプリケーションのハンドラーは、処理する項目の同期を実行します。 ハンドラーに含まれている場合は、 Isyncmgrsynchronize インターフェイスを実装する必要があります。 また、アプリケーションで同期できる個別の項目に対して、列挙子オブジェクトと Isyncmgrenumitems を指定する必要があります。

受け取ったりは、 ISyncMgrSynchronizeCallbackISyncMgrSynchronizeInvokeを実装します。

受け取ったりは、 Isyncmgrsynchronize 内のメソッドを呼び出して、アプリケーションが処理する項目に関する情報を取得し、これらの項目を同期するために提供するハンドラーに関する情報を取得します。

実行時に、同期プロセスは次の手順に従います。

  1. 受け取ったりは、 Isyncmgrsynchronize:: Initialize メソッドを呼び出すことによって、アプリケーションが処理する項目の1つに対して同期が行われる時間をアプリケーションに通知します。
  2. 受け取ったりは Isyncmgrsynchronize:: EnumSyncMgrItems を呼び出して、アプリケーションによって処理される項目の Isyncmgrenumitems インターフェイスを取得します。
  3. 受け取ったりは Isyncmgrsynchronize:: SetProgressCallback を呼び出して、ハンドラーに ISyncMgrSynchronizeCallback インターフェイスのインターフェイスポインターを提供します。 ハンドラーは、このインターフェイスを使用して、同期中に受け取ったりにコールバックします。
  4. 次に、受け取ったりは Isyncmgrsynchronize::P repareforsync メソッドを呼び出して、同期を開始する前に必要なユーザーインターフェイス要素を表示する機会をハンドラーに与えます。 たとえば、電子メールアプリケーションでは、ユーザーのログオンダイアログが表示される場合があります。
  5. ハンドラーは、ユーザーインターフェイス要素を表示する前と後に、 ISyncMgrSynchronizeCallback:: EnableModeless を呼び出します。 完了すると、ハンドラー は ISyncMgrSynchronizeCallback::P repareforsynccompleted を呼び出します。
  6. 受け取ったりは、 Isyncmgrsynchronize:: Synchronize メソッドを呼び出して、同期を開始します。

同期プロセス中、受け取ったりは引き続き Isyncmgrsynchronize インターフェイスのメソッドを呼び出します。 ハンドラーのエラー、進行状況、通知を送信できます。 また、アプリケーションが処理する項目を列挙したり、アプリケーションが項目のプロパティを表示できるようにしたりすることもできます。

ハンドラーは、 ISyncMgrSynchronizeCallback のメソッドを呼び出して、項目をスキップする必要があるかどうかを判断し、エラーをログに記録し、同期プロセス中に進行状況情報をポストします。

詳細については、関連するインターフェイスの関連するリファレンスページを参照してください。

同期が完了すると、ハンドラーは ISyncMgrSynchronizeCallback:: SynchronizeCompletedを呼び出します。