ISyncMgrUIOperation インターフェイス (syncmgr.h)

同期ハンドラーまたは同期項目が、同期センターによって要求されたときに UI オブジェクトを表示できるメソッドを公開します。

継承

ISyncMgrUIOperation インターフェイスは、IUnknown インターフェイスから継承されます。 ISyncMgrUIOperation には、次の種類のメンバーもあります。

メソッド

ISyncMgrUIOperation インターフェイスには、これらのメソッドがあります。

ISyncMgrUIOperation::Run 同期センターから要求されたときに、ハンドラーまたは同期項目の UI の実際の表示を実行します。

解説

ハンドラーは、特定のアクションの UI を提供するために ISyncMgrUIOperation を実装します。 それぞれの個別のアクション (参照、スケジュール、有効化/無効化、アクティブ化/非アクティブ化、削除) には、個別の実装が必要です。

ハンドラーは、UI を表示する操作にのみこのインターフェイスを実装する必要があります。

このインターフェイスをインスタンス化して使用するために Sync Center が実行する手順を次に示します。

1. Sync Center では、UI 操作用に別のスレッドが作成されます。
2. Sync Center によってハンドラーの新しいインスタンスが作成されます。
3. 操作にハンドラーのみが含まれる場合、Sync Center は適切なSYNCMGR_OBJECTID オブジェクト ID を使用して ISyncMgrHandler::GetObject を呼び出し、その UI オブジェクトを実装する ISyncMgrUIOperation へのポインターを取得します。 たとえば、Sync Center は ISyncMgrHandler::GetObject を SYNCMGR_OBJECTID_QueryBeforeDelete で呼び出して、ユーザーがハンドラーの削除を選択したときに UI を表示するために呼び出されるオブジェクトを取得し、実際に削除することを確認するように求めます。
4. 操作に同期項目が含まれる場合、同期センターは次のような一連の呼び出しを行います。
   1. QueryInterface は 、ISyncMgrSyncItemContainer のインスタンスを取得するために ISyncMgrHandler インターフェイスで呼び出されます。
   2. ISyncMgrSyncItemContainer::GetSyncItem は、アイテムを表す ISyncMgrSyncItem インスタンスへのポインターを取得するために呼び出されます。
   3. ISyncMgrSyncItem::GetObject は、UI オブジェクトを実装する ISyncMgrUIOperation へのポインターを取得するために、適切なSYNCMGR_OBJECTID オブジェクト ID で呼び出されます。
5. Sync Center は、UI オブジェクトの Run メソッドを呼び出して UI を表示します。

UI を別のインターフェイスとして実装することで、同期とは別に UI の表示を実行できます。 ISyncMgrUIOperation は、ISyncMgrHandler または ISyncMgrSyncItem とは異なるオブジェクトに実装する必要があります。

ユーザーがアクションを要求し、最初のアクションが完了する前に同じアクションをもう一度要求すると、最初のアクションの UI がアクティブ化され、フォアグラウンドに移動されます。

要件

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