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 repositório de mensagens MAPI sincronizar itens do Microsoft Outlook 2013 ou do Microsoft Outlook 2010 entre um servidor e um repositório local privado baseado em .pst criado para esse provedor.

Observação

Um provedor de repositório de mensagens MAPI deve implementar a API de Replicação de acordo com as instruções em Sobre a máquina de estado de replicação. O provedor deve usar a API somente em um repositório pessoal criado para si mesmo, e não em repositórios pessoais criados 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 Microsoft Exchange.

Para usar a API de Replicação, um provedor de repositório de mensagens MAPI deve primeiro abrir e encapsular um repositório local baseado em .pst chamando NSTServiceEntry. O provedor pode então usar as principais interfaces da API, IOSTX e IPSTX, para realizar a replicação. O IPSTX é fornecido consultando IMsgStore: IMAPIProp e o IOSTX é fornecido pelo IPSTX::GetSyncObject.

A interface IOSTX

A interface IOSTX é a interface principal que executa a sincronização na API de replicação. O IOSTX move o repositório local por uma série de estados, recuperando informações em cada estado sobre alterações no repositório local, além de informar o repositório local sobre 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 repositório, como cliente dessa API, usa a API de Replicação para encapsular o repositório local e percorrer esses estados, enviando alterações no repositório local (como alterações na hierarquia de pastas ou a adição de novos itens) para o 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 a Sincronização de Alterações Incrementais (ICS) fornecida pelo Microsoft Exchange Server. Para obter mais informações sobre 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 no conteúdo em um repositório local.

A interface IPSTX

O IPSTX e cinco outras 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 com que o repositório local emule o Gerenciador de Protocolo do Outlook para spool de mensagens de saída para um servidor.

Para obter mais informações sobre transições de estado durante a replicação, consulte Sobre a máquina de estado de replicação.

A API de Replicação

A API de Replicação fornece as seguintes definições, tipos de dados e interfaces. Para obter um exemplo de implementação de um provedor de repositório para arquivos de Pastas Particulares (PST) encapsulados, consulte Sobre o provedor de repositório PST encapsulado de exemplo.

Definições:

Funções:

Tipos de dados:

Interfaces:

  • Last updated on