共用方式為


(syncmgr.h) ISyncMgrUIOperation 介面

公開同步處理常式或同步處理專案可在同步中心要求時顯示 UI 物件的方法。

繼承

ISyncMgrUIOperation介面繼承自IUnknown介面。 ISyncMgrUIOperation 也有下列類型的成員:

方法

ISyncMgrUIOperation介面具有這些方法。

 
ISyncMgrUIOperation::Run

當同步中心要求執行此動作時,執行處理常式或同步專案的實際 UI 顯示。

備註

處理常式會實作 ISyncMgrUIOperation ,以提供特定動作的 UI。 每個個別的動作 (流覽、排程、啟用/停用、啟用/停用和刪除) 需要個別的實作。

處理常式應該只針對想要呈現 UI 的作業實作此介面。

下列摘要說明同步處理中心用來具現化和使用這個介面的步驟。

  1. 同步處理中心會為 UI 作業建立個別的執行緒。
  2. 同步處理中心會建立處理常式的新實例。
  3. 如果作業只牽涉到處理程式,同步中心會使用適當的SYNCMGR_OBJECTID物件識別碼呼叫ISyncMgrHandler::GetObject,以取得實作該 UI 物件的ISyncMgrUIOperation指標。 例如,同步中心會呼叫 ISyncMgrHandler::GetObjectSYNCMGR_OBJECTID_QueryBeforeDelete ,以取得當使用者選擇刪除處理常式時要顯示 UI 的物件,要求確認他們確實想要刪除它。
  4. 如果作業涉及同步處理專案,同步中心會進行一系列呼叫,包括下列專案:
    1. ISyncMgrHandler介面上呼叫QueryInterface,以擷取ISyncMgrSyncItemContainer的實例。
    2. 系統會呼叫 ISyncMgrSyncItemContainer::GetSyncItem ,以取得代表專案的 ISyncMgrSyncItem 實例指標。
    3. 使用適當的SYNCMGR_OBJECTID物件識別碼呼叫ISyncMgrSyncItem::GetObject,以取得實作 UI 物件的ISyncMgrUIOperation指標。
  5. 同步中心會呼叫 UI 物件的 Run 方法來顯示 UI。
藉由實作 UI 做為個別介面,即可獨立執行 UI 的顯示。 ISyncMgrUIOperation 應該在 與 ISyncMgrHandlerISyncMgrSyncItem不同的物件上實作。

如果使用者要求動作,則在第一個動作完成之前再次要求相同的動作,則會啟動初始動作的 UI 並帶入前景。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 syncmgr.h