ISyncChangeBatchBase::AddItemMetadataToGroup
지정된 항목 변경 내용을 현재 열려 있는 그룹에 추가합니다.
HRESULT AddItemMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwFlags,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
매개 변수
- pbOwnerReplicaId
[in] pChangeVersion과 pCreationVersion이 유효하면 복제본의 복제본 ID입니다. ID 형식은 공급자의 ID_PARAMETERS 구조에서 지정한 형식과 일치해야 합니다.
- pbItemId
[in] 항목의 ID입니다. ID 형식은 공급자의 ID_PARAMETERS 구조에서 지정한 형식과 일치해야 합니다.
- pChangeVersion
[in] 이 변경 내용의 버전입니다.
- pCreationVersion
[in] 항목의 생성 버전입니다.
- dwFlags
[in] 항목 변경 내용의 상태를 지정하는 플래그입니다. 플래그 값은 SYNC_CHANGE_FLAG 플래그를 참조하십시오.
- dwWorkForChange
[in] 변경 내용에 대한 작업 예상률입니다. 이 값은 변경 내용을 적용하는 동안 완료된 작업을 응용 프로그램에 보고하는 데 사용됩니다.
- ppChangeBuilder
[in, out, unique] 변경 내용에 변경 단위 정보를 추가하는 데 사용할 수 있는 개체를 반환합니다.
반환 값
S_OK
dwFlags에 잘못된 플래그 값이 포함되면 E_INVALIDARG입니다.
열려 있는 그룹이 없거나 이전에 빈 그룹이 일괄 처리에 추가되었으면 SYNC_E_INVALID_OPERATION입니다.
정렬된 그룹이 열려 있고 pbItemId가 그룹에 추가된 이전 항목의 항목 ID보다 작거나 그룹을 열 때 지정된 항목 ID보다 작으면 SYNC_E_RANGE_OUT_OF_ORDER입니다.
ISyncChangeBatchBase 개체가 변경 내용 적용자 또는 동기화 세션에 전송되었거나 IProviderSyncServices::DeserializeChangeBatch 또는 IProviderSyncServices::DeserializeFullEnumerationChangeBatch를 사용하여 개체가 만들어졌으면 SYNC_E_CHANGE_BATCH_IS_READ_ONLY입니다.
참고 항목
참조
ISyncChangeBatchBase 인터페이스
SYNC_VERSION 구조