Freigeben über

SYNCMGR_HANDLER_CAPABILITIES-Enumeration (syncmgr.h)

  • Artikel

Gibt die Funktionen eines Handlers in Bezug auf die Aktionen an, die für ihn ausgeführt werden können.

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
} ;

Konstanten

 
SYNCMGR_HCM_NONE
Wert: 0
Es werden keine Funktionsflags festgelegt.
SYNCMGR_HCM_PROVIDES_ICON
Wert: 0x1
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem SYNCMGR_OBJECTID_Icon-Flag aufgerufen wird. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss IExtractIcon implementieren. Im Allgemeinen sollte dieser Wert nach Möglichkeit nicht zurückgegeben werden.
SYNCMGR_HCM_EVENT_STORE
Wert: 0x2
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem SYNCMGR_OBJECTID_EventStore-Flag aufgerufen wird. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrEventStore implementieren.
SYNCMGR_HCM_CONFLICT_STORE
Wert: 0x4
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem flag SYNCMGR_OBJECTID_ConflictStore aufgerufen wird. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrConflictStore implementieren.
SYNCMGR_HCM_SUPPORTS_CONCURRENT_SESSIONS
Wert: 0x10
Wenn ein Handler dieses Flag in der Maske festlegt, die von der ISyncMgrHandler::GetCapabilities-Methode des Handlers zurückgegeben wird, gibt dies an, dass der Handler mehrere gleichzeitige Synchronisierungssitzungen mit ISyncMgrSessionCreator::CreateSession erstellt. Dies ist nützlich für Handler, die eine Hintergrundsynchronisierungsarchitektur implementieren, in der der Handler einfach einen anderen Prozess signalisiert, die Synchronisierung durchzuführen, anstatt die Synchronisierung in seiner ISyncMgrHandler::Synchronize-Methode direkt auszuführen. Dadurch können Synchronisierungs-Engines Fortschritt, Konflikte und Ereignisse (über ISyncMgrSyncCallback) melden, wenn Synchronisierungsanforderungen aus anderen Quellen als dem Synchronisierungscenter stammen. Dies kann beispielsweise das Ergebnis einer Datenänderungsbenachrichtigung oder über eine anwendungsspezifische Benutzeroberfläche sein. Wenn mehrere Sitzungen dasselbe Element synchronisieren, wird der Fortschritt für dieses Element als unbestimmt gemeldet.
SYNCMGR_HCM_CAN_BROWSE_CONTENT
Wert: 0x10000
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem SYNCMGR_OBJECTID_BrowseContent-Flag aufgerufen wird. Wenn dieser Wert festgelegt ist, wird der Task Inhalt durchsuchen dem Kontextmenü des Handlers hinzugefügt. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrUIOperation implementieren.
SYNCMGR_HCM_CAN_SHOW_SCHEDULE
Wert: 0x20000
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem flag SYNCMGR_OBJECTID_ShowSchedule aufgerufen wird. Wenn dieser Wert festgelegt ist, wird der Task Zeitplan anzeigen dem Kontextmenü des Handlers hinzugefügt. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrUIOperation implementieren. Dieser Wert wird von ISyncMgrScheduleWizardUIOperation verwendet.
SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE
Wert: 0x100000
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem SYNCMGR_OBJECTID_QueryBeforeActivate-Flag aufgerufen wird. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrUIOperation implementieren.
SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE
Wert: 0x200000
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem flag SYNCMGR_OBJECTID_QueryBeforeDeactivate aufgerufen wird. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrUIOperation implementieren.
SYNCMGR_HCM_QUERY_BEFORE_ENABLE
Wert: 0x400000
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem flag SYNCMGR_OBJECTID_QueryBeforeEnable aufgerufen wird. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrUIOperation implementieren.
SYNCMGR_HCM_QUERY_BEFORE_DISABLE
Wert: 0x800000
Der Handler gibt ein gültiges Objekt aus ISyncMgrHandler::GetObject zurück, wenn diese Methode mit dem SYNCMGR_OBJECTID_QueryBeforeDisable-Flag aufgerufen wird. Das von ISyncMgrHandler::GetObject zurückgegebene Objekt muss ISyncMgrUIOperation implementieren.
SYNCMGR_HCM_VALID_MASK
Wert: 0xf30017
Eine Maske, die zum Bestimmen gültiger SYNCMGR_HANDLER_CAPABILITIES Flags verwendet wird. Vergleichen Sie mit dem von ISyncMgrHandler::GetCapabilities abgerufenen Wert, um gültige Ergebnisse zu überprüfen.

Hinweise

Sync Center fragt den Handler nach seinen Funktionen über ISyncMgrHandler::GetCapabilities ab, wenn die ISyncMgrControl::UpdateHandler - oder ISyncMgrControl::UpdateHandlerCollection-Methode aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile syncmgr.h