(syncmgr.h) ISyncMgrUIOperation 介面
公開同步處理常式或同步處理專案可在同步中心要求時顯示 UI 物件的方法。
繼承
ISyncMgrUIOperation介面繼承自IUnknown介面。 ISyncMgrUIOperation 也有下列類型的成員:
方法
ISyncMgrUIOperation介面具有這些方法。
ISyncMgrUIOperation::Run 當同步中心要求執行此動作時,執行處理常式或同步專案的實際 UI 顯示。 |
備註
處理常式會實作 ISyncMgrUIOperation ,以提供特定動作的 UI。 每個個別的動作 (流覽、排程、啟用/停用、啟用/停用和刪除) 需要個別的實作。
處理常式應該只針對想要呈現 UI 的作業實作此介面。
下列摘要說明同步處理中心用來具現化和使用這個介面的步驟。
- 同步處理中心會為 UI 作業建立個別的執行緒。
- 同步處理中心會建立處理常式的新實例。
- 如果作業只牽涉到處理程式,同步中心會使用適當的SYNCMGR_OBJECTID物件識別碼呼叫ISyncMgrHandler::GetObject,以取得實作該 UI 物件的ISyncMgrUIOperation指標。 例如,同步中心會呼叫 ISyncMgrHandler::GetObject 與 SYNCMGR_OBJECTID_QueryBeforeDelete ,以取得當使用者選擇刪除處理常式時要顯示 UI 的物件,要求確認他們確實想要刪除它。
- 如果作業涉及同步處理專案,同步中心會進行一系列呼叫,包括下列專案:
- 在ISyncMgrHandler介面上呼叫QueryInterface,以擷取ISyncMgrSyncItemContainer的實例。
- 系統會呼叫 ISyncMgrSyncItemContainer::GetSyncItem ,以取得代表專案的 ISyncMgrSyncItem 實例指標。
- 使用適當的SYNCMGR_OBJECTID物件識別碼呼叫ISyncMgrSyncItem::GetObject,以取得實作 UI 物件的ISyncMgrUIOperation指標。
- 同步中心會呼叫 UI 物件的 Run 方法來顯示 UI。
如果使用者要求動作,則在第一個動作完成之前再次要求相同的動作,則會啟動初始動作的 UI 並帶入前景。
規格需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | syncmgr.h |