SYNCMGR_HANDLER_CAPABILITIES-Enumeration (syncmgr.h)

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