Implementar una aplicación de sincronización

Una aplicación de sincronización es un componente de software que crea una sesión de sincronización, la conecta con dos proveedores de sincronización, la utiliza para iniciar la sincronización y hospeda Sync Framework durante la sincronización. La aplicación de sincronización también se puede registrar para controlar los eventos notificados por Sync Framework.

Implementar una aplicación de sincronización

Una aplicación de sincronización se puede implementar utilizando código administrado o no administrado.

Seguridad Nota
Sync Framework trata los proveedores de sincronización como código de confianza. Por consiguiente, una aplicación que llama a un proveedor de sincronización debe establecer que el proveedor sea de confianza, ya sea teniendo el conocimiento explícito del proveedor o utilizando algún otro mecanismo, como una firma digital.

Implementar una aplicación de sincronización utilizando código administrado

Para crear e iniciar una sesión de sincronización, una aplicación hace lo siguiente:

1. Crea un objeto SyncOrchestrator.

2. Establece las propiedades LocalProvider y RemoteProvider del organizador.

3. Establece la propiedad Direction del organizador en la dirección de sincronización adecuada. En la dirección de Upload, el objeto LocalProvider es el origen y el objeto RemoteProvider es el destino. En la dirección de Download, el objeto LocalProvider es el destino y el objeto RemoteProvider es el origen. Tenga en cuenta que la sincronización bidireccional se puede realizar utilizando DownloadAndUpload o UploadAndDownload.

4. Llama al método Synchronize del organizador. De esta forma se crea una sesión en nombre de la aplicación que administrará todas las tareas de sincronización adicionales. Si la aplicación desea cancelar la sincronización, puede llamar al método Cancel.

Implementar una aplicación de sincronización utilizando código no administrado

Para crear e iniciar un objeto de sesión de sincronización, una aplicación hace lo siguiente:

1. Crea un objeto IApplicationSyncServices. Esto se consigue llamando a CoCreateInstance y pasándole CLSID_SyncServices como CLSID e IID_IApplicationSyncServices como IID.

2. Crea un objeto ISyncSession. Para ello, se llama al método IApplicationSyncServices::CreateSyncSession . Dos proveedores se pasan a este método: uno como proveedor de destino y otro como proveedor de origen.

3. Llama al método ISyncSession::Start. A continuación, Sync Framework administra todas las tareas de sincronización adicionales. Si la aplicación desea cancelar la sincronización, se puede llamar al método ISyncSession::Cancel.

4. Una vez completada la sincronización, se puede conseguir una sincronización bidireccional creando otro objeto de sesión, revirtiendo el proveedor de origen y el proveedor de destino, y llamando a ISyncSession::Start en el nuevo objeto de sesión.

Para obtener más información acerca de cómo crear una aplicación de sincronización, vea Crear una aplicación de sincronización no administrada.

Eventos de sincronización

Una aplicación puede registrarse para recibir notificaciones de diversos eventos durante la sincronización. Las dos razones principales para controlar eventos son realizar el seguimiento de su progreso e implementar un mecanismo de control de conflictos personalizado.

Código administrado Implemente métodos de controlador de eventos y regístrelos con el objeto SyncOrchestrator o con un objeto SyncCallbacks.

Código no administrado Use el método ISyncSession::RegisterCallback para registrar un objeto que implemente la interfaz ISyncCallback.

Para obtener más información, vea Responder a eventos de sincronización.

Vea también

Referencia

Interfaz IApplicationSyncServices
Interfaz ISyncSession
Interfaz ISyncCallback
SyncOrchestrator
SyncCallbacks

Conceptos

Microsoft Sync Framework
Aspectos básicos de los proveedores personalizados
Responder a eventos de sincronización