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

[アーティクル]
08/24/2023

同期する登録済みアプリケーションをユーザーが選択した後、選択したグループごとに同期マネージャーによって 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::Synchronize メソッド (mobsync.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース