SYNCMGR_HANDLER_CAPABILITIES列舉 (syncmgr.h)

  • 發行項

指定處理程式有關可對其執行之動作的功能。

Syntax

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