Sobre a API de replicação
Aplica-se a: Outlook 2013 | Outlook 2016
A API de Replicação fornece a funcionalidade para um provedor de armazenamento de mensagens MAPI sincronizar Microsoft Outlook 2013 ou Microsoft Outlook 2010 itens entre um servidor e um repositório local privado baseado em .pst criado para esse provedor.
Observação
Um provedor de armazenamento de mensagens MAPI deve implementar a API de Replicação de acordo com as instruções em Sobre o Computador de Estado de Replicação. O provedor deve usar a API apenas em um repositório pessoal criado para si mesmo e não em lojas pessoais criadas para outros provedores, pois os repositórios pessoais criados para outros provedores podem já ter configurado seus próprios mecanismos de replicação com o respectivo servidor. Por exemplo, um arquivo de pasta offline (.ost) mantém sua própria relação de replicação com um servidor do Microsoft Exchange.
Para usar a API de Replicação, um provedor de repositório de mensagens MAPI deve primeiro abrir e encerrar um repositório local baseado em .pst chamando NSTServiceEntry. Em seguida, o provedor pode usar as principais interfaces da API, IOSTX e IPSTX para realizar a replicação. O IPSTX é fornecido consultando no IMsgStore : IMAPIProp e O IOSTX é fornecido por IPSTX::GetSyncObject.
A interface IOSTX
A interface IOSTX é a interface primária que executa a sincronização na API de Replicação. O IOSTX move o repositório local por meio de uma série de estados, recuperando informações em cada estado sobre alterações no repositório local, bem como informando o repositório local de alterações no servidor. A API de Replicação também especifica muitas estruturas de dados que dão suporte à sincronização.
Um provedor de armazenamento, como cliente dessa API, usa a API de Replicação para envolver o repositório local e passar por esses estados, empurrando alterações no repositório local (como alterações na hierarquia de pastas ou a adição de novos itens) ao servidor e também recuperando informações sobre alterações no servidor e fornecendo essas informações para a interface IOSTX . A interface IOSTX adota o ICS (Incremental Change Synchronization) fornecido pelo Microsoft Exchange Server. Para obter mais informações sobre o ICS, consulte Critérios de avaliação do ICS. Por meio do IOSTX, o cliente usa o ICS para monitorar e sincronizar alterações incrementais na hierarquia ou conteúdo em um repositório local.
A interface IPSTX
IPSTX e outras cinco interfaces IPSTX n que herdam do IPSTX fornecem funcionalidade auxiliar que pode ser usada ao executar a replicação por meio da interface IOSTX . Por exemplo, IPSTX::EmulateSpooler permite que você faça o repositório local emular o Gerenciador de Protocolos do Outlook para enviar mensagens de saída para um servidor.
Para obter mais informações sobre transições de estado durante a replicação, consulte Sobre o Computador de Estado de Replicação.
A API de Replicação
A API de Replicação fornece as seguintes definções, tipos de dados e interfaces. Para obter uma implementação de exemplo de um provedor de repositório para arquivos de pastas pessoais encapsulados (PST), consulte Sobre o Provedor de Repositório PST encapsulado de exemplo.
Definições:
Funções:
Tipos de dados:
Interfaces: