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

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

構文

HRESULT Synchronize(
  [in] HWND hWndParent
);

パラメーター

[in] hWndParent

型: HWND

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

戻り値

種類: HRESULT

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

リターン コード	説明
S_OK	同期が成功しました。
E_FAIL	同期に失敗しました。

解説

ユーザーが登録済みアプリケーションの項目の選択肢を選択しない場合、 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 メソッドは、アプリケーション内の任意のスレッドで呼び出すことができます。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	mobsync.h
[DLL]	Mobsync.dll

関連項目

ISyncMgrSynchronize

ISyncMgrSynchronize::Initialize

ISyncMgrSynchronize::P repareForSync

ISyncMgrSynchronize::SetProgressCallback

ISyncMgrSynchronize::ShowError

SynchronizeCompleted