Compartir a través de


Información sobre la API de replicación

Hace referencia a: Outlook 2013 | Outlook 2016

La API de replicación proporciona la funcionalidad para que un proveedor de almacén de mensajes MAPI sincronice Microsoft Outlook 2013 o Microsoft Outlook 2010 elementos entre un servidor y un almacén local privado basado en .pst creado para ese proveedor.

Nota:

Un proveedor de almacén de mensajes MAPI debe implementar la API de replicación según las instrucciones de Acerca de la máquina de estado de replicación. El proveedor debe usar la API solo en un almacén personal creado para sí mismo y no en almacenes personales creados para otros proveedores, ya que es posible que los almacenes personales creados para otros proveedores ya hayan configurado sus propios mecanismos de replicación con el servidor correspondiente. Por ejemplo, un archivo de carpeta sin conexión (.ost) mantiene su propia relación de replicación con un servidor de Microsoft Exchange.

Para usar la API de replicación, un proveedor de almacén de mensajes MAPI primero debe abrir y encapsular un almacén local basado en .pst mediante una llamada a NSTServiceEntry. A continuación, el proveedor puede usar las interfaces principales de la API, IOSTX e IPSTX, para llevar a cabo la replicación. IPSTX se proporciona consultando en IMsgStore : IMAPIProp y IOSTX lo proporciona IPSTX::GetSyncObject.

Interfaz IOSTX

La interfaz IOSTX es la interfaz principal que realiza la sincronización en la API de replicación. IOSTX mueve el almacén local a través de una serie de estados, recuperando información en cada estado sobre los cambios en el almacén local, así como informando al almacén local de los cambios en el servidor. La API de replicación también especifica muchas estructuras de datos que admiten la sincronización.

Un proveedor de almacén, como cliente de esta API, usa la API de replicación para encapsular el almacén local y moverse por estos estados, insertando cambios en el almacén local (como cambios en la jerarquía de carpetas o la adición de nuevos elementos) al servidor, y también recuperando información sobre los cambios en el servidor y proporcionando esa información a la interfaz IOSTX . La interfaz IOSTX adopta la sincronización de cambios incrementales (ICS) proporcionada por Microsoft Exchange Server. Para obtener más información sobre ICS, vea Criterios de evaluación de ICS. A través de IOSTX, el cliente usa ICS para supervisar y sincronizar los cambios incrementales con la jerarquía o el contenido de un almacén local.

La interfaz IPSTX

IPSTX y otras cinco interfaces de IPSTX n que heredan de IPSTX proporcionan funcionalidad auxiliar que se puede usar al realizar la replicación a través de la interfaz IOSTX . Por ejemplo, IPSTX::EmulateSpooler permite que el almacén local emula el Administrador de protocolos de Outlook para colar mensajes salientes en un servidor.

Para obtener más información sobre las transiciones de estado durante la replicación, consulte Acerca de la máquina de estado de replicación.

La API de replicación

La API de replicación proporciona las siguientes definciones, tipos de datos e interfaces. Para obtener una implementación de ejemplo de un proveedor de almacenamiento para archivos de carpetas personales ajustadas (PST), vea Acerca del proveedor de almacén PST encapsulado de ejemplo.

Definiciones:

Funciones:

Tipos de datos:

Interfaces: