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 |