ISyncChangeBatchBase::BeginOrderedGroup
Apre un gruppo ordinato nel batch di modifiche. Questo gruppo è ordinato in base all'ID elemento.
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
Parametri
- pbLowerBound
[in] Limite inferiore chiuso di ID elemento per questo gruppo ordinato. Per specificare un limite inferiore pari a 0, utilizzare NULL.
Valore restituito
S_OK
SYNC_E_INVALID_OPERATION se un gruppo è già aperto o un gruppo vuoto è stato precedentemente aggiunto al batch.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY se l'oggetto ISyncChangeBatchBase è stato creato utilizzando IProviderSyncServices::DeserializeChangeBatch o IProviderSyncServices::DeserializeFullEnumerationChangeBatch o se l'oggetto è un oggetto ISyncFullEnumerationChangeBatch e un gruppo è già stato aggiunto al batch.
SYNC_E_RANGE_OUT_OF_ORDER se l'oggetto è un oggetto ISyncFullEnumerationChangeBatch e pbLowerBound è superiore all'ID del limite inferiore utilizzato per creare il batch.
Osservazioni
Le modifiche dell'elemento aggiunte al batch di modifiche dopo la chiamata a questo metodo vengono aggiunte al gruppo aperto. Le modifiche dell'elemento aggiunte a un gruppo ordinato devono essere aggiunte in ordine crescente in base all'ID elemento.
Non è possibile aggiungere modifiche dell'elemento al batch di modifiche finché non viene aperto un gruppo.