ISyncMgrSynchronize::P repareForSync メソッド (mobsync.h)

登録されたアプリケーションが任意のユーザー インターフェイスを表示し、 ISyncMgrSynchronize::Synchronize メソッドが呼び出される前に必要な初期化を実行できるようにします。 たとえば、Microsoft Outlook メール クライアントなどのアプリケーションでは、ユーザーがメール サーバーにログオンできるようにするために、パスワード ダイアログ ボックスを表示する必要がある場合があります。

構文

HRESULT PrepareForSync(
  [in] ULONG cbNumItems,
  [in] GUID  *pItemIDs,
  [in] HWND  hWndParent,
  [in] DWORD dwReserved
);

パラメーター

[in] cbNumItems

種類: ULONG

pItemIDs が指す配列内の項目の数。

[in] pItemIDs

型: GUID*

ユーザーが同期を選択した項目 ID の配列。

[in] hWndParent

型: HWND

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

[in] dwReserved

型: DWORD

予約済み。 登録されているアプリケーションでは、この値を無視する必要があります。

戻り値

型: HRESULT

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

解説

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

登録されたアプリケーションでは、ISyncMgrSynchronize::Initialize メソッドの dwSyncFlags パラメーターに SYNCMGRFLAG_MAYBOTHERUSER フラグが設定されている場合にのみ、ユーザー インターフェイスを表示する必要があります。 SYNCMGRFLAG_MAYBOTHERUSER フラグが設定されていないときにユーザー インターフェイスを表示しないと、登録済みアプリケーションで同期の準備ができない場合は、このメソッドからS_FALSEを返す必要があります。

このメソッドに渡される項目 ID の配列は、 ISyncMgrSynchronize::Synchronize メソッドにも関連しています。

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

要件

関連項目

ISyncMgrSynchronize

ISyncMgrSynchronize::Initialize

ISyncMgrSynchronize::Synchronize

ISyncMgrSynchronizeCallback

PrepareForSyncCompleted

SYNCMGRFLAG