enumeración SYNCMGR_HANDLER_CAPABILITIES (syncmgr.h)

Especifica las funcionalidades de un controlador con respecto a las acciones que se pueden realizar en él.

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

Constantes

 
SYNCMGR_HCM_NONE
Valor: 0
No se establecen marcas de funcionalidad.
SYNCMGR_HCM_PROVIDES_ICON
Valor: 0x1
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_Icon. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar IExtractIcon. Por lo general, este valor no se debe devolver si es posible.
SYNCMGR_HCM_EVENT_STORE
Valor: 0x2
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_EventStore. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrEventStore.
SYNCMGR_HCM_CONFLICT_STORE
Valor: 0x4
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_ConflictStore. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrConflictStore.
SYNCMGR_HCM_SUPPORTS_CONCURRENT_SESSIONS
Valor: 0x10
Si un controlador establece esta marca en la máscara devuelta desde el método ISyncMgrHandler::GetCapabilities del controlador, indica que el controlador planea crear varias sesiones de sincronización simultáneas mediante ISyncMgrSessionCreator::CreateSession. Esto es útil para los controladores que implementan una arquitectura de sincronización en segundo plano en la que el controlador simplemente señala otro proceso para realizar la sincronización en lugar de realizar la sincronización en su método ISyncMgrHandler::Synchronize directamente. Esto permite que los motores de sincronización notifiquen el progreso, los conflictos y los eventos (a través de ISyncMgrSyncCallback) cuando las solicitudes de sincronización proceden de orígenes distintos del Centro de sincronización. Por ejemplo, esto podría ser el resultado de una notificación de cambio de datos o a través de una interfaz de usuario específica de la aplicación. Si más de una sesión está sincronizando el mismo elemento, el progreso de ese elemento se notificará como indeterminado.
SYNCMGR_HCM_CAN_BROWSE_CONTENT
Valor: 0x10000
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_BrowseContent. Si se establece este valor, la tarea Examinar contenido se agrega al menú contextual del controlador. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrUIOperation.
SYNCMGR_HCM_CAN_SHOW_SCHEDULE
Valor: 0x20000
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_ShowSchedule. Si se establece este valor, la tarea Mostrar programación se agrega al menú contextual del controlador. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrUIOperation. ISyncMgrScheduleWizardUIOperation usa este valor.
SYNCMGR_HCM_QUERY_BEFORE_ACTIVATE
Valor: 0x100000
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_QueryBeforeActivate. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrUIOperation.
SYNCMGR_HCM_QUERY_BEFORE_DEACTIVATE
Valor: 0x200000
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_QueryBeforeDeactivate. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrUIOperation.
SYNCMGR_HCM_QUERY_BEFORE_ENABLE
Valor: 0x400000
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_QueryBeforeEnable. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrUIOperation.
SYNCMGR_HCM_QUERY_BEFORE_DISABLE
Valor: 0x800000
El controlador devuelve un objeto válido de ISyncMgrHandler::GetObject cuando se llama a ese método con la marca SYNCMGR_OBJECTID_QueryBeforeDisable. El objeto devuelto desde ISyncMgrHandler::GetObject debe implementar ISyncMgrUIOperation.
SYNCMGR_HCM_VALID_MASK
Valor: 0xf30017
Máscara usada para determinar marcas de SYNCMGR_HANDLER_CAPABILITIES válidas. Compare con el valor recuperado por ISyncMgrHandler::GetCapabilities para comprobar los resultados válidos.

Comentarios

El Centro de sincronización consulta el controlador para sus funcionalidades a través de ISyncMgrHandler::GetCapabilities cada vez que se llama al método ISyncMgrControl::UpdateHandler o ISyncMgrControl::UpdateHandlerCollection .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado syncmgr.h