ISyncFullEnumerationChangeBatch2::AddMergeTombstoneMetadataToGroup
Agrega el marcador de exclusión de combinación especificado al grupo que se encuentra abierto.
HRESULT AddMergeTombstoneMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbWinnerItemId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
Parámetros
- pbOwnerReplicaId
[in] Identificador de la réplica donde pChangeVersion y pCreationVersion son válidos. El formato del identificador debe coincidir con el formato especificado en la estructura ID_PARAMETERS del proveedor.
- pbWinnerItemId
[in] Identificador del elemento una vez que se ha producido la combinación. Se denomina también identificador ganador. El formato del identificador debe coincidir con el formato especificado en la estructura ID_PARAMETERS del proveedor.
- pbItemId
[in] Identificador del elemento antes de que se produjera la combinación. Se denomina también identificador perdedor. El formato del identificador debe coincidir con el formato especificado en la estructura ID_PARAMETERS del proveedor.
- pChangeVersion
[in] Versión de este cambio.
- pCreationVersion
[in] Versión de creación del elemento.
- dwWorkForChange
[in] Estimación de trabajo para el cambio. Este valor se utiliza durante la aplicación de los cambios para notificar a la aplicación que el trabajo se ha completado.
- ppChangeBuilder
[in, out, unique] Devuelve un objeto que se puede usar para agregar información de la unidad de cambio al cambio.
Valor devuelto
S_OK
E_POINTER
SYNC_E_CHANGE_BATCH_IS_READ_ONLY si el objeto de ISyncFullEnumerationChangeBatch2 se ha enviado a un aplicador de cambios o a la sesión de sincronización, o si el objeto se creó con IProviderSyncServices::DeserializeFullEnumerationChangeBatch.
SYNC_E_INVALID_OPERATION si no hay ningún grupo abierto, o si anteriormente se agregó un grupo vacío al lote.
SYNC_E_RANGE_OUT_OF_ORDER si un grupo ordenado está abierto y pbItemId es menor que el identificador del elemento anterior que se agregó al grupo o menor que el identificador de elemento que se especificó al abrir el grupo.
Notas
Se crea un marcador de exclusión de combinación cuando se resuelve un conflicto de restricción combinando los dos elementos en conflicto. Cuando un conflicto de restricción se resuelve mediante combinación, el más pequeño de los identificadores de elemento se selecciona como identificador de elemento ganador y el identificador más grande será el del perdedor. El identificador de elemento ganador se utiliza para identificar el elemento combinado. El marcador de exclusión de combinación hace un seguimiento al identificador de elemento que ha perdido para comprobar que identifica al mismo elemento como identificador de elemento que ha ganado en la comunidad de sincronización. Los metadatos de un marcador de exclusión de combinación son los mismos que los del marcador de exclusión del elemento eliminado, con la salvedad de que se agrega el identificador del elemento que ha ganado.
Vea también
Referencia
Interfaz ISyncFullEnumerationChangeBatch2