Enumeração SYNC_SAVE_ACTION
Representa o tipo de ação indicada por uma alteração.
typedef enum
{
SSA_CREATE,
SSA_UPDATE_VERSION_ONLY,
SSA_UPDATE_VERSION_AND_DATA,
SSA_UPDATE_VERSION_AND_MERGE_DATA,
SSA_DELETE_AND_STORE_TOMBSTONE,
SSA_DELETE_AND_REMOVE_TOMBSTONE,
SSA_RENAME_SOURCE_AND_UPDATE_VERSION_AND_DATA,
SSA_RENAME_DESTINATION_AND_UPDATE_VERSION_AND_DATA,
SSA_DELETE_CONFLICTING_AND_SAVE_SOURCE_ITEM,
SSA_STORE_MERGE_TOMBSTONE,
SSA_CHANGE_ID_UPDATE_VERSION_AND_MERGE_DATA,
SSA_CHANGE_ID_UPDATE_VERSION_AND_SAVE_DATA,
SSA_CHANGE_ID_UPDATE_VERSION_AND_DELETE_AND_STORE_TOMBSTONE,
SSA_CHANGE_ID_UPDATE_VERSION_ONLY,
SSA_CREATE_GHOST,
SSA_GHOST_ITEM,
SSA_UNGHOST_ITEM,
SSA_UPDATE_GHOST,
SSA_DELETE_GHOST_AND_STORE_TOMBSTONE,
SSA_DELETE_GHOST_WITHOUT_TOMBSTONE
} SYNC_SAVE_ACTION;
Membros
- SSA_CREATE
O item é novo e é criado no repositório de itens de destino.
- SSA_UPDATE_VERSION_ONLY
Os dados do item não são alterados no repositório de itens de destino. A versão é substituída nos metadados de destino. Essa ação também ocorre quando o item do provedor de destino é selecionado como o vencedor de um conflito.
- SSA_UPDATE_VERSION_AND_DATA
Os dados do item são aplicados ao repositório de itens de destino. Os dados existentes são substituídos. A versão fornecida substitui a versão existente nos metadados de destino. Essa ação corresponde a uma criação ou atualização de item, ou a uma atualização de unidade de alteração na réplica de origem. Essa ação também ocorre quando o item do provedor de origem é selecionado como o vencedor de um conflito.
- SSA_UPDATE_VERSION_AND_MERGE_DATA
Os dados do item são aplicados ao repositório de itens de destino. Dados de item existentes são mesclados com os dados de item atualizados usando algum método específico de provedor. A versão substitui a versão existente nos metadados de destino. Essa ação ocorre quando a ação de resolução de conflitos é SRA_MERGE.
- SSA_DELETE_AND_STORE_TOMBSTONE
O item é excluído do repositório de itens de destino. Uma marca de exclusão é salva nos metadados de destino. A ação corresponde à exclusão de um item da réplica de origem.
- SSA_DELETE_AND_REMOVE_TOMBSTONE
O item é excluído do repositório de itens de destino. Uma marca de exclusão não é mantida nos metadados de destino. Se existir uma marca de exclusão para o item nos metadados de destino, ela deverá ser removida. Essa ação é invocada durante uma recuperação de conhecimento esquecido e corresponde a exclusões de itens em que a réplica de origem limpou a marca de exclusão.
- SSA_RENAME_SOURCE_AND_UPDATE_VERSION_AND_DATA
A alteração enviada a partir do provedor de origem é renomeada para não colidir mais com o item conflitante na réplica de destino, e a alteração de origem é aplicada à réplica de destino.
- SSA_RENAME_DESTINATION_AND_UPDATE_VERSION_AND_DATA
O item conflitante na réplica de destino é renomeado para não colidir mais com a alteração enviada a partir do provedor de origem, e a alteração de origem é aplicada à réplica de destino.
- SSA_DELETE_CONFLICTING_AND_SAVE_SOURCE_ITEM
A alteração de origem é aplicada à réplica de destino e o item de destino conflitante é excluído da réplica de destino.
SSA_STORE_MERGE_TOMBSTONE
Armazenar uma marca de exclusão de mesclagem nos metadados de destino. Considere uma ação de mesclagem que especifica id1 como a ID de item perdedora e id2 como a ID de item vencedora. Essa marca contém id1 como a ID de item perdedora e id2 como a ID de item vencedora. Se uma marca de exclusão de mesclagem já existir na réplica de destino que contém id1 como a ID de item perdedora e outra ID de item, id3, como a ID de item vencedora, execute as etapas a seguir.Se id2 for menor que id3, crie e armazene duas marcas de exclusão de mesclagem. Uma dessas marcas contém id1 como a ID de item perdedora e id2 como a ID de item vencedora. A outra marca contém id2 como a ID de item perdedora e id3 como a ID de item vencedora. Essa segunda marca de exclusão de mesclagem pode já existir e, nesse caso, ela não é afetada. Desse modo, uma cadeia de marcas de exclusão de mesclagem é criada, ordenada pela ID do item.
Se id3 for menos que id2, retorne um erro.
- SSA_CHANGE_ID_UPDATE_VERSION_AND_MERGE_DATA
Os dados do item de origem são combinados com o item de destino. Armazene uma marca de exclusão de mesclagem para a ID de item perdedora, seguindo as mesmas etapas indicadas para SSA_STORE_MERGE_TOMBSTONE.
- SSA_CHANGE_ID_UPDATE_VERSION_AND_SAVE_DATA
Armazene uma marca de exclusão de mesclagem para a ID de item perdedora, seguindo as mesmas etapas indicadas para SSA_STORE_MERGE_TOMBSTONE.
- SSA_CHANGE_ID_UPDATE_VERSION_AND_DELETE_AND_STORE_TOMBSTONE
Armazene uma marca de exclusão de mesclagem para a ID de item perdedora, seguindo as mesmas etapas indicadas para SSA_STORE_MERGE_TOMBSTONE. Exclua o item identificado pela ID de item vencedora e armazene uma marca de exclusão para ele.
- SSA_CHANGE_ID_UPDATE_VERSION_ONLY
Armazene uma marca de exclusão de mesclagem para a ID de item perdedora, seguindo as mesmas etapas indicadas para SSA_STORE_MERGE_TOMBSTONE. Aplique somente metadados para a alteração de item vencedor.
- SSA_CREATE_GHOST
Crie um fantasma para o item. Um fantasma é um item que contém um valor que indica se ele estava recentemente no filtro, e uma versão de movimentação para fora. Uma versão de movimentação para fora indica a versão da alteração que removeu o item do filtro.
- SSA_GHOST_ITEM
Altere o item ativo para um fantasma. Para fazer isso, armazene um valor que indica que o item estava recentemente no filtro, armazene a versão dessa alteração como a versão de movimentação para fora do item e remova os dados de item do repositório de itens.
- SSA_UNGHOST_ITEM
Ative o item fantasma. Para fazer isso, remova a versão de movimentação para fora dos metadados e armazene os dados de item no repositório de itens.
- SSA_UPDATE_GHOST
Atualize a versão de um item fantasma. Essa é uma atualização para a versão atual do item, não para a versão de movimentação para fora.
- SSA_DELETE_GHOST_AND_STORE_TOMBSTONE
Altere um item fantasma para uma marca de exclusão. Isso indica que o item foi excluído. Para isso, armazene um valor que indica que o item foi excluído.
- SSA_DELETE_GHOST_WITHOUT_TOMBSTONE
Remova o item fantasma do repositório de metadados e não armazene uma marca de exclusão para o item.
Comentários
Quando o provedor não está usando uma transação para todo o lote de alterações, ele deve recuperar o conhecimento atualizado do objeto ISaveChangeContext e salvar esse conhecimento no momento em que aplicar a alteração.
Requisitos
Cabeçalho: Synchronization.h
Consulte também
Referência
Interface ISaveChangeWithChangeUnitsContext
Interface ISynchronousNotifyingChangeApplierTarget
Interface IAsynchronousNotifyingChangeApplierTarget
Interface IFeedBuilder