다음을 통해 공유


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 구조

개념

동기화 진행률 보고