Compartilhar via


IOSTX : IUnknown

Aplica-se a: Outlook 2013 | Outlook 2016

Fornece métodos de sincronização. Essa interface recupera as informações necessárias para replicar alterações locais no servidor e no servidor de alterações no repositório local.

Propriedade Valor
Provided by:
IPSTX::GetSyncObject
Identificador de interface:
IID_IOSTX

Vtable order

Propriedade Valor
Getlasterror
Obtém informações estendidas sobre o último erro.
InitSync
Informa ao repositório local que a sincronização está prestes a começar.
SyncBeg
Prepara o repositório local para sincronização em um estado específico e recupera as informações necessárias para replicar.
SyncEnd
Termina a sincronização no estado atual e sai desse estado.
SyncHdrBeg
Inicia a sincronização de um cabeçalho de mensagem.
SyncHdrEnd
Encerra a sincronização de um cabeçalho de mensagem.
SetSyncResult
Define o resultado da sincronização.
Membro espaço reservado
Não há suporte nem documentado.

Comentários

Quando um cliente carrega ou sincroniza pastas e conteúdos de pastas em um repositório local, ele move o repositório local de um estado para outro, conforme descrito no diagrama de transição de estado em About the Replication State Machine. A seguir está a ordem de eventos para o cliente mover o repositório local de um estado para outro:

  1. O cliente chama IOSTX::InitSync para informar ao repositório local que a replicação está prestes a começar.

  2. Dependendo da direção da replicação e dos objetos a serem replicados, o cliente chama IOSTX::SyncBeg para iniciar a replicação no estado apropriado. O Outlook fornece ao cliente as informações necessárias e o cliente executa a replicação.

  3. O cliente chama IOSTX::SetSyncResult para retornar o resultado da replicação.

  4. O cliente chama IOSTX::SyncEnd para encerrar a replicação, fornecendo ao Outlook as informações necessárias para a replicação subsequente.

Em particular, ao baixar itens de mensagem, o cliente usa IOSTX::SyncHdrBeg e IOSTX::SyncHdrEnd para atualizar um item de mensagem completo com o cabeçalho da mensagem na loja local:

  1. Após IOSTX::SyncHdrBeg, o repositório local faz a transição para o estado do cabeçalho da mensagem de download. Inicialmente, o Outlook fornece ao cliente o cabeçalho de mensagem atual no repositório local.

  2. O cliente baixa um item de mensagem completo junto com o cabeçalho da mensagem.

  3. O Outlook atualiza o item no repositório local com o item de mensagem completo.

Confira também

Sobre a API de replicação

Constantes de MAPI