ISyncChangeBatchBase::BeginOrderedGroup
Abre un grupo ordenado en el lote de cambios. Este grupo se ordena por identificador de elemento.
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
Parámetros
- pbLowerBound
[in] Límite inferior cerrado de los identificadores de elemento para este grupo ordenado. Para especificar un límite inferior de 0, use NULL.
Valor devuelto
S_OK
SYNC_E_INVALID_OPERATION si ya hay un grupo abierto, o si anteriormente se agregó un grupo vacío al lote.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY si el objeto ISyncChangeBatchBase se creó con IProviderSyncServices::DeserializeChangeBatch o IProviderSyncServices::DeserializeFullEnumerationChangeBatch, o si el objeto es un objeto ISyncFullEnumerationChangeBatch y ya se ha agregado un grupo al lote.
SYNC_E_RANGE_OUT_OF_ORDER si el objeto es un objeto ISyncFullEnumerationChangeBatch y pbLowerBound es mayor que el identificador del límite inferior que se usó para crear el lote.
Notas
Los cambios de elemento que se agregan al lote de cambios después de llamar a este método se agregan al grupo abierto. Los cambios de elemento que se agregan a un grupo ordenado se deben agregar en orden ascendente según el identificador de elemento.
No se pueden agregar cambios de elemento al lote de cambios hasta que se abre un grupo.