ISaveChangeContext2::SetConstraintConflictOnChange
Relata que um conflito de restrição ocorreu quando o provedor de destino tentou aplicar a alteração à réplica de destino.
HRESULT SetConstraintConflictOnChange(
const BYTE * pbConflictingItemId,
CONSTRAINT_CONFLICT_REASON constraintConflictReason);
Parâmetros
- pbConflictingItemId
[in, unique] A ID do item de destino que está em conflito com a alteração a ser aplicada.
- constraintConflictReason
[in] O motivo pelo qual o conflito ocorreu.
Valor de retorno
S_OK.
E_INVALIDARG quando constraintConflictReason não for um valor válido, ou quando constraintConflictReason for CCR_COLLISION e pbConflictingItemId for NULL.
SYNC_E_INVALID_OPERATION se um conflito de restrição ou um erro recuperável já tiver sido definido nesse objeto.
Comentários
Um conflito de restrição ocorre quando um provedor de destino tenta aplicar uma alteração à réplica de destino, e essa alteração viola uma restrição da réplica de destino, como a relação de pastas ou o local de dados com o mesmo nome em um sistema de arquivos.
Quando o provedor de destino usa esse método para relatar um conflito de restrição, o aplicador de alterações resolve o conflito de acordo com a política de resolução de conflitos definida para a sessão ou de acordo com a ação de resolução de conflitos definida pelo aplicativo para o conflito especificado. O aplicador de alterações então despacha as chamadas necessárias para o provedor de destino, para que este possa aplicar o conflito resolvido à réplica de destino. Para obter mais informações, consulte Detectando e solucionando conflitos de restrição.