ISyncChangeBatch2::AddMergeTombstoneMetadataToGroup
지정된 병합 삭제 표식을 현재 열려 있는 그룹에 추가합니다.
HRESULT AddMergeTombstoneMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbWinnerItemId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
매개 변수
- pbOwnerReplicaId
[in] pChangeVersion과 pCreationVersion이 유효하면 복제본의 복제본 ID입니다. ID 형식은 공급자의 ID_PARAMETERS 구조에서 지정한 형식과 일치해야 합니다.
- pbWinnerItemId
[in] 병합이 발생한 후 항목의 ID입니다. 이 ID를 적용 ID라고도 합니다. ID 형식은 공급자의 ID_PARAMETERS 구조에서 지정한 형식과 일치해야 합니다.
- pbItemId
[in] 병합이 발생하기 전 항목의 ID입니다. 이 ID를 무시 ID라고도 합니다. ID 형식은 공급자의 ID_PARAMETERS 구조에서 지정한 형식과 일치해야 합니다.
- pChangeVersion
[in] 이 변경 내용의 버전입니다.
- pCreationVersion
[in] pbItemId로 식별된 항목의 생성 버전입니다.
- dwWorkForChange
[in] 변경 내용에 대한 작업 예상률입니다. 이 값은 변경 내용을 적용하는 동안 완료된 작업을 응용 프로그램에 보고하는 데 사용됩니다.
- ppChangeBuilder
[in, out, unique] 변경 내용에 변경 단위 정보를 추가하는 데 사용할 수 있는 개체를 반환합니다.
반환 값
S_OK
E_POINTER
ISyncChangeBatch2 개체가 변경 내용 적용자 또는 동기화 세션에 전송되었거나 IProviderSyncServices::DeserializeChangeBatch 또는 IProviderSyncServices::DeserializeFullEnumerationChangeBatch를 사용하여 개체가 만들어졌으면 SYNC_E_CHANGE_BATCH_IS_READ_ONLY입니다.
열려 있는 그룹이 없거나 이전에 빈 그룹이 일괄 처리에 추가되었으면 SYNC_E_INVALID_OPERATION입니다.
정렬된 그룹이 열려 있고 pbItemId가 그룹에 추가된 이전 항목의 항목 ID보다 작거나 그룹을 열 때 지정된 항목 ID보다 작으면 SYNC_E_RANGE_OUT_OF_ORDER입니다.
주의
충돌하는 두 항목을 병합하여 제약 조건 충돌을 해결하면 병합 삭제 표식이 만들어집니다. 병합을 통해 제약 조건 충돌이 해결되는 경우 적용 항목 ID로 선택한 항목 ID가 작을수록 무시 항목 ID는 커집니다. 적용 항목 ID는 병합된 항목을 식별하는 데 사용됩니다. 병합 삭제 표식은 동기화 커뮤니티에서 무시 항목 ID가 적용 항목 ID와 동일한 항목을 식별하는지 추적합니다. 병합 삭제 표식의 메타데이터는 삭제된 항목 삭제 표식의 메타데이터에 적용 항목 ID가 추가된 것과 같습니다.