ISyncChangeBatchBase::AddItemMetadataToGroup
Adiciona uma alteração de item específica ao grupo que está aberto no momento.
HRESULT AddItemMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwFlags,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
Parâmetros
- pbOwnerReplicaId
[in] A ID da réplica onde pChangeVersion e pCreationVersion são válidos. O formato da ID deve corresponder ao formato especificado pela estrutura ID_PARAMETERS do provedor.
- pbItemId
[in] A ID do item. O formato da ID deve corresponder ao formato especificado pela estrutura ID_PARAMETERS do provedor.
- pChangeVersion
[in] A versão dessa alteração.
- pCreationVersion
[in] A versão de criação do item.
- dwFlags
[in] Sinalizadores que especificam o estado da alteração do item. Para obter valores de sinalizadores, consulte Sinalizadores SYNC_CHANGE_FLAG.
- dwWorkForChange
[in] A estimativa de trabalho para a alteração. Esse valor é usado durante a aplicação de alterações para relatar o trabalho concluído ao aplicativo.
- ppChangeBuilder
[in, out, unique] Retorna um objeto que pode ser usado para adicionar informações da unidade de alteração à alteração.
Valor de retorno
S_OK
E_INVALIDARG quando dwFlags contiver um valor de sinalizador que não é válido.
SYNC_E_INVALID_OPERATION quando nenhum grupo estiver aberto ou um grupo vazio foi previamente adicionado ao lote.
SYNC_E_RANGE_OUT_OF_ORDER quando um grupo ordenado estiver aberto e pbItemId for menor do que a ID do item anterior adicionado ao grupo, ou menor do que a ID especificada quando o grupo foi aberto.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY quando o objeto ISyncChangeBatchBase tiver sido enviado a um aplicador de alterações ou à sessão de sincronização, ou quando o objeto foi criado usando IProviderSyncServices::DeserializeChangeBatch ou IProviderSyncServices::DeserializeFullEnumerationChangeBatch.
Consulte também
Referência
Interface ISyncChangeBatchBase
Estrutura SYNC_VERSION