ISyncChangeBatchBase::BeginOrderedGroup
Ouvre un groupe ordonné dans le lot de modifications. Ce groupe est ordonné par ID d'élément.
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
Paramètres
- pbLowerBound
[in] Limite inférieure fermée des ID d'élément de ce groupe ordonné. Pour spécifier la limite inférieure 0, utilisez la propriété NULL.
Valeur de retour
S_OK
SYNC_E_INVALID_OPERATION si un groupe est déjà ouvert ou qu'un groupe vide a été ajouté précédemment au lot.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY lorsque l'objet ISyncChangeBatchBase a été créé en utilisant IProviderSyncServices::DeserializeChangeBatch ou IProviderSyncServices::DeserializeFullEnumerationChangeBatch, ou lorsqu'il s'agit d'un objet ISyncFullEnumerationChangeBatch et qu'un groupe a déjà été ajouté au lot.
SYNC_E_RANGE_OUT_OF_ORDER lorsque l'objet est un objet ISyncFullEnumerationChangeBatch et que pbLowerBound est supérieur à l'ID de limite inférieure utilisée pour créer le lot.
Notes
Les modifications d'élément qui sont ajoutées au lot de modifications après l'appel de cette méthode sont ajoutées au groupe ouvert. Les modifications d'élément ajoutées à un groupe ordonné doivent être ajoutées dans l'ordre croissant par ID d'élément.
Les modifications d'élément ne peuvent pas être ajoutées au lot de modifications tant qu'un groupe n'est pas ouvert.