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 メソッドは、登録済みアプリケーション内の任意のスレッドで呼び出すことができます。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mobsync.h |
| [DLL] | Mobsync.dll |
関連項目
ISyncMgrSynchronize::Initialize