ISyncMgrSynchronize::Synchronize メソッド (mobsync.h)

同期する登録済みアプリケーションをユーザーが選択した後、選択したグループごとに同期マネージャーによって 1 回呼び出されます。

構文

HRESULT Synchronize(
  [in] HWND hWndParent
);

パラメーター

[in] hWndParent

型: HWND

登録されたアプリケーションが表示するユーザー インターフェイス要素に対して、親 HWND へのハンドルを使用する必要があります。 この値は NULL である可能性があります。

戻り値

種類: HRESULT

このメソッドは、標準の戻り値、E_INVALIDARG、E_UNEXPECTED、およびE_OUTOFMEMORYをサポートします。

解説

ユーザーが登録済みアプリケーションの項目の選択肢を選択しない場合、 ISyncMgrSynchronize::Synchronize メソッドは呼び出されず、インターフェイスが解放されます。 このメソッドが呼び出された場合、アプリケーションは ISyncMgrSynchronize::P repareForSync メソッドで指定された項目を同期する必要があります。

登録されたアプリケーションのハンドラーは、できるだけ早く ISyncMgrSynchronize::Synchronize メソッドからを返し、 SynchronizeCompleted メソッドを呼び出す必要があります。 ISyncMgrSynchronize::Synchronize メソッドから戻る前に、ハンドラーが SynchronizeCompleted 呼び出しを呼び出してもかまいません。

アプリケーションは進行状況のフィードバックを提供し、ISyncMgrSynchronize::SetProgressCallback メソッドで設定された pSyncCallBack インターフェイス ポインターを使用して同期を取り消す必要があるかどうかをチェックする必要があります。

ISyncMgrSynchronize::Initialize でSYNCMGRFLAG_MAYBOTHERUSER フラグが指定されていない場合でも、アプリケーションは進行状況情報を提供する必要があります。

アプリケーションでは、 ISyncMgrSynchronize::Synchronize メソッド内からユーザー インターフェイス要素を表示しないようにする必要があります。 ISyncMgrSynchronize::P repareForSync メソッドと ISyncMgrSynchronize::ShowError メソッドにユーザー インターフェイス要素を表示して、エンド ユーザーがログオンと同期する共有を指定する一貫したユーザー インターフェイスを体験できるようにする必要があります。 その後、ユーザーの介入なしに同期を実行できます。 同期が完了すると、競合やその他のエラー メッセージを表示できます。

ISyncMgrSynchronizeCallback メソッドは、アプリケーション内の任意のスレッドで呼び出すことができます。

要件

関連項目

ISyncMgrSynchronize

ISyncMgrSynchronize::Initialize

ISyncMgrSynchronize::P repareForSync

ISyncMgrSynchronize::SetProgressCallback

ISyncMgrSynchronize::ShowError

SynchronizeCompleted