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

перечисление SYNCMGR_HANDLER_CAPABILITIES (syncmgr.h)

  • Статья

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

Синтаксис

typedef enum SYNCMGR_HANDLER_CAPABILITIES {
  SYNCMGR_HCM_NONE = 0,
  SYNCMGR_HCM_PROVIDES_ICON = 0x1,
  SYNCMGR_HCM_EVENT_STORE = 0x2,
  SYNCMGR_HCM_CONFLICT_STORE = 0x4,
  SYNCMGR_HCM_SUPPORTS_CONCURRENT_SESSIONS = 0x10,
  SYNCMGR_HCM_CAN_BROWSE_CONTENT = 0x10000,
  SYNCMGR_HCM_CAN_SHOW_SCHEDULE = 0x20000,
  SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE = 0x100000,
  SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE = 0x200000,
  SYNCMGR_HCM_QUERY_BEFORE_ENABLE = 0x400000,
  SYNCMGR_HCM_QUERY_BEFORE_DISABLE = 0x800000,
  SYNCMGR_HCM_VALID_MASK = 0xf30017
} ;

Константы

 
SYNCMGR_HCM_NONE
Значение: 0
Флаги возможностей не заданы.
SYNCMGR_HCM_PROVIDES_ICON
Значение: 0x1
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_Icon. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать IExtractIcon. Как правило, это значение не должно возвращаться, если это возможно.
SYNCMGR_HCM_EVENT_STORE
Значение: 0x2
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_EventStore. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrEventStore.
SYNCMGR_HCM_CONFLICT_STORE
Значение: 0x4
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_ConflictStore. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrConflictStore.
SYNCMGR_HCM_SUPPORTS_CONCURRENT_SESSIONS
Значение: 0x10
Если обработчик задает этот флаг в маске, возвращаемой методом ISyncMgrHandler::GetCapabilities обработчика , он указывает, что обработчик планирует создать несколько одновременных сеансов синхронизации с помощью ISyncMgrSessionCreator::CreateSession. Это полезно для обработчиков, реализующих архитектуру фоновой синхронизации, в которой обработчик просто сигнализирует другому процессу о выполнении синхронизации, а не выполняет синхронизацию в методе ISyncMgrHandler::Synchronize напрямую. Это позволяет обработчикам синхронизации сообщать о ходе выполнения, конфликтах и событиях (через ISyncMgrSyncCallback), когда запросы синхронизации поступают из источников, отличных от Центра синхронизации. Например, это может быть результатом уведомления об изменении данных или с помощью пользовательского интерфейса конкретного приложения. Если несколько сеансов синхронизируют один и тот же элемент, ход выполнения этого элемента будет считаться неопределенным.
SYNCMGR_HCM_CAN_BROWSE_CONTENT
Значение: 0x10000
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_BrowseContent. Если это значение задано, задача "Обзор содержимого " добавляется в контекстное меню обработчика. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrUIOperation.
SYNCMGR_HCM_CAN_SHOW_SCHEDULE
Значение: 0x20000
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_ShowSchedule. Если это значение задано, задача "Показать расписание " добавляется в контекстное меню обработчика. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrUIOperation. Это значение используется ISyncMgrScheduleWizardUIOperation.
SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE
Значение: 0x100000
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_QueryBeforeActivate. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrUIOperation.
SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE
Значение: 0x200000
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_QueryBeforeDeactivate. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrUIOperation.
SYNCMGR_HCM_QUERY_BEFORE_ENABLE
Значение: 0x400000
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_QueryBeforeEnable. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrUIOperation.
SYNCMGR_HCM_QUERY_BEFORE_DISABLE
Значение: 0x800000
Обработчик возвращает допустимый объект из ISyncMgrHandler::GetObject при вызове этого метода с флагом SYNCMGR_OBJECTID_QueryBeforeDisable. Объект, возвращаемый из ISyncMgrHandler::GetObject , должен реализовывать ISyncMgrUIOperation.
SYNCMGR_HCM_VALID_MASK
Значение: 0xf30017
Маска, используемая для определения допустимых флагов SYNCMGR_HANDLER_CAPABILITIES . Сравните значение, полученное ISyncMgrHandler::GetCapabilities , чтобы проверить допустимые результаты.

Комментарии

Центр синхронизации запрашивает у обработчика его возможности через ISyncMgrHandler::GetCapabilities при каждом вызове метода ISyncMgrControl::UpdateHandler или ISyncMgrControl::UpdateHandlerCollection .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть syncmgr.h