ISyncChangeBatch2::AddMergeTombstoneMetadataToGroup
Ajoute l'objet tombstone de fusion spécifié au groupe qui est actuellement ouvert.
Syntaxe
HRESULT AddMergeTombstoneMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbWinnerItemId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
Paramètres
pbOwnerReplicaId
[in] ID du réplica où pChangeVersion et pCreationVersion sont valides. Le format d'ID doit correspondre au format spécifié par la structure ID_PARAMETERS du fournisseur.pbWinnerItemId
[in] ID de l'élément après la fusion. Cette valeur est également appelée ID gagnant. Le format d'ID doit correspondre au format spécifié par la structure ID_PARAMETERS du fournisseur.pbItemId
[in] ID de l'élément avant la fusion. Cette valeur est également appelée ID perdant. Le format d'ID doit correspondre au format spécifié par la structure ID_PARAMETERS du fournisseur.pChangeVersion
[in] Version de cette modification.pCreationVersion
[in] Version de création de l'élément identifié par pbItemId.dwWorkForChange
[in] Estimation du travail pour la modification. Cette valeur est utilisée pendant l'application des modifications pour signaler un travail achevé à l'application.ppChangeBuilder
[in, out, unique] Retourne un objet qui peut être utilisé pour ajouter des informations d'unité de modification à la modification.
Valeur de retour
S_OK.
E_POINTER.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY lorsque l'objet ISyncChangeBatch2 a été envoyé à un applicateur de modifications ou à la session de synchronisation, ou lorsque l'objet a été créé en utilisant IProviderSyncServices::DeserializeChangeBatch ou IProviderSyncServices::DeserializeFullEnumerationChangeBatch.
SYNC_E_INVALID_OPERATION si aucun groupe n'est ouvert ou qu'un groupe vide a été ajouté précédemment au lot.
SYNC_E_RANGE_OUT_OF_ORDER lorsqu'un groupe ordonné est ouvert et que pbItemId est inférieur à l'ID de l'élément précédent qui a été ajouté au groupe ou inférieur à l'ID d'élément spécifié quand le groupe a été ouvert.
Notes
Un objet tombstone de fusion est créé lorsqu'un conflit de contraintes est résolu en fusionnant les deux éléments en conflit. Lorsqu'un conflit de contraintes est résolu par une fusion, le plus petit des ID d'élément est choisi comme ID d'élément gagnant et le plus grand comme ID d'élément perdant. L'ID d'élément gagnant est utilisé pour identifier l'élément fusionné. L'objet tombstone de fusion détecte que l'ID d'élément perdant identifie le même élément que l'ID d'élément gagnant dans la communauté de synchronisation. Les métadonnées d'un objet tombstone de fusion sont les mêmes que pour un objet tombstone d'élément supprimé, avec en plus l'ID d'élément gagnant.