ISyncChangeBatchBase::BeginOrderedGroup
Abre um grupo ordenado no lote de alterações. Esse grupo é ordenado pela ID do item.
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
Parâmetros
- pbLowerBound
[in] O limite inferior fechado das IDs de item desse grupo ordenado. Para especificar um limite inferior igual a 0, use NULL.
Valor de retorno
S_OK
SYNC_E_INVALID_OPERATION quando um grupo já estiver aberto ou quando um grupo vazio tiver sido adicionado anteriormente ao lote.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY quando o objeto ISyncChangeBatchBase for criado usando IProviderSyncServices::DeserializeChangeBatch ou IProviderSyncServices::DeserializeFullEnumerationChangeBatch ou quando o objeto for um ISyncFullEnumerationChangeBatch e um grupo já estiver adicionado ao lote.
SYNC_E_RANGE_OUT_OF_ORDER quando o objeto for ISyncFullEnumerationChangeBatch e pbLowerBound for maior que o limite inferior da ID usada para criar o lote.
Comentários
As alterações de item adicionadas ao lote de alterações depois de este método ser chamado são adicionadas ao grupo aberto. As alterações de item adicionadas a um grupo ordenado devem ser adicionadas em ordem crescente pela ID do item.
As alterações de item não podem ser adicionadas ao lote de alterações até que um grupo seja aberto.