Поделиться через

Интерфейс ISyncMgrUIOperation (syncmgr.h)

  • Статья

Предоставляет метод, с помощью которого обработчик синхронизации или элемент синхронизации могут отображать объект пользовательского интерфейса по запросу центра синхронизации.

Наследование

Интерфейс ISyncMgrUIOperation наследуется от интерфейса IUnknown . ISyncMgrUIOperation также имеет следующие типы членов:

Методы

Интерфейс ISyncMgrUIOperation содержит следующие методы.

 
ISyncMgrUIOperation::Run

Выполняет фактическое отображение пользовательского интерфейса для обработчика или элемента синхронизации по запросу центра синхронизации.

Комментарии

Обработчики реализуют ISyncMgrUIOperation для предоставления пользовательского интерфейса для определенного действия. Для каждого отдельного действия (просмотр, планирование, включение и отключение, активация, деактивация и удаление) требуется отдельная реализация.

Обработчик должен реализовывать этот интерфейс только для операций, для которых он хочет представить пользовательский интерфейс.

Ниже приведена сводка действий, которые центр синхронизации выполняет для создания экземпляра и использования этого интерфейса.

  1. Центр синхронизации создает отдельный поток для операции пользовательского интерфейса.
  2. Центр синхронизации создает новый экземпляр обработчика.
  3. Если операция включает только обработчик, центр синхронизации вызывает ISyncMgrHandler::GetObject с соответствующим идентификатором объекта SYNCMGR_OBJECTID , чтобы получить указатель на ISyncMgrUIOperation , который реализует этот объект пользовательского интерфейса. Например, центр синхронизации вызывает ISyncMgrHandler::GetObject с SYNCMGR_OBJECTID_QueryBeforeDelete , чтобы получить объект, который вызывается для отображения пользовательского интерфейса, когда пользователь выбирает удалить обработчик, запрашивая подтверждение того, что он действительно хочет удалить его.
  4. Если операция включает элемент синхронизации, центр синхронизации выполняет ряд вызовов, включая следующие:
    1. QueryInterface вызывается в интерфейсе ISyncMgrHandler для получения экземпляра ISyncMgrSyncItemContainer.
    2. Метод ISyncMgrSyncItemContainer::GetSyncItem вызывается для получения указателя на экземпляр ISyncMgrSyncItem , представляющий элемент.
    3. Метод ISyncMgrSyncItem::GetObject вызывается с соответствующим идентификатором объекта SYNCMGR_OBJECTID , чтобы получить указатель на ISyncMgrUIOperation , реализующий объект пользовательского интерфейса.
  5. Центр синхронизации вызывает метод Run объекта пользовательского интерфейса для отображения пользовательского интерфейса.
Реализуя пользовательский интерфейс как отдельный интерфейс, отображение пользовательского интерфейса можно выполнять независимо от синхронизации. ISyncMgrUIOperation следует реализовать в объекте, отличном от объекта ISyncMgrHandler или ISyncMgrSyncItem.

Если пользователь запрашивает действие, а затем запрашивает это же действие еще раз до завершения первого действия, пользовательский интерфейс для начального действия активируется и отображается на переднем плане.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header syncmgr.h