ISyncMgrSessionCreator

ハンドラーまたは外部アプリケーションが、同期の開始を Sync Center に通知したり、進行状況やイベントを報告したりするための単一のメソッドを公開します。

このインターフェイスは ISyncMgrHandler::Synchronize に渡されます。ハンドラーは、その Synchronize 実装内でセッションを作成することを選択できます。これにより、ハンドラー自身が進行状況やイベントを報告したり、進行状況やイベントを報告するバックグラウンドプロセスへシグナルを送ったりできます。

あるいは、ハンドラーは外部プロセスにシグナルを送って CLSID_SyncMgrClient オブジェクトを作成させることもできます。ハンドラーがサービスなどの外部プロセスで自動同期を実行するように実装されている場合、Sync Center がユーザー向けの UI を更新できるよう、Sync Center に進行状況を報告できる必要があります。また、ハンドラーは Sync Center の Sync Results フォルダーにイベントを追加できる必要もあります。外部プロセスは、CLSCTX_SERVER フラグと ISyncMgrSessionCreator IID を CoCreateInstance に渡すことで CLSID_SyncMgrClient オブジェクトを作成します。これにより、そのプロセスは進行状況やイベントを報告できるほか、ユーザーが同期をキャンセルしたかどうかを Sync Center に問い合わせることもできます。ただし、ISyncMgrSessionCreator は外部プロセスへマーシャリングできない点に注意してください。

指定された項目の同期が開始されたことを Sync Center に通知します。

型: HRESULT

このメソッドが成功した場合、S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

pszHandlerID と ppszItemIDs の両方を指定する必要があります。

例

次の例は、このメソッドの実装の概要を示しています。

STDMETHODIMP CMyDeviceHandler::Synchronize(...)
{
    ...
    ISyncMgrSyncCallback *pCallback = NULL;

    hr = pCreator->CreateSession(_pszHandlerID, ppszItemIDs, cItems, &pCallback);
    if (SUCCEEDED(hr))
    {
        // 同期を実行します。
    }

    return hr;
}