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 当使用 SYNCMGR_OBJECTID_Icon 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 IExtractIcon。 通常，如果可能，不应返回此值。
SYNCMGR_HCM_EVENT_STORE 值： 0x2 当使用 SYNCMGR_OBJECTID_EventStore 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrEventStore。
SYNCMGR_HCM_CONFLICT_STORE 值： 0x4 当使用 SYNCMGR_OBJECTID_ConflictStore 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrConflictStore。
SYNCMGR_HCM_SUPPORTS_CONCURRENT_SESSIONS 值： 0x10 如果处理程序在处理程序的 ISyncMgrHandler：：GetCapabilities 方法返回的掩码中设置此标志，则表示处理程序计划使用 ISyncMgrSessionCreator：：CreateSession 创建多个同步会话。 这对于实现后台同步体系结构的处理程序非常有用，在该体系结构中，处理程序只向另一个进程发出信号来执行同步，而不是直接在其 ISyncMgrHandler：：Synchronize 方法中执行同步。 这样，当同步请求来自同步中心以外的源时，同步引擎可以通过 ISyncMgrSyncCallback) 报告 (进度、冲突和事件。 例如，这可能是数据更改通知或通过特定于应用程序的 UI 的结果。 如果多个会话正在同步同一项，则该项目的进度将报告为不确定。
SYNCMGR_HCM_CAN_BROWSE_CONTENT 值： 0x10000 当使用 SYNCMGR_OBJECTID_BrowseContent 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 如果设置了此值，“ 浏览内容” 任务将添加到处理程序的快捷菜单中。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrUIOperation。
SYNCMGR_HCM_CAN_SHOW_SCHEDULE 值： 0x20000 当使用 SYNCMGR_OBJECTID_ShowSchedule 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 如果设置了此值，则会将 “显示计划” 任务添加到处理程序的快捷菜单中。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrUIOperation。 此值由 ISyncMgrScheduleWizardUIOperation 使用。
SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE 值： 0x100000 当使用 SYNCMGR_OBJECTID_QueryBeforeActivate 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrUIOperation。
SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE 值： 0x200000 当使用 SYNCMGR_OBJECTID_QueryBeforeDeactivate 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrUIOperation。
SYNCMGR_HCM_QUERY_BEFORE_ENABLE 值： 0x400000 当使用 SYNCMGR_OBJECTID_QueryBeforeEnable 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrUIOperation。
SYNCMGR_HCM_QUERY_BEFORE_DISABLE 值： 0x800000 当使用 SYNCMGR_OBJECTID_QueryBeforeDisable 标志调用该方法时，处理程序从 ISyncMgrHandler：：GetObject 返回有效对象。 从 ISyncMgrHandler：：GetObject 返回的对象必须实现 ISyncMgrUIOperation。
SYNCMGR_HCM_VALID_MASK 值： 0xf30017 用于确定有效 SYNCMGR_HANDLER_CAPABILITIES 标志的掩码。 与 ISyncMgrHandler：：GetCapabilities 检索的值进行比较，以验证有效结果。

注解

每当调用 ISyncMgrControl：：UpdateHandler 或 ISyncMgrControl：：UpdateHandlerCollection 方法时，同步中心通过 ISyncMgrHandler：：GetCapabilities 查询处理程序的功能。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	syncmgr.h