ISyncChangeBatchBase::BeginOrderedGroup
Öffnet im Änderungsbatch eine geordnete Gruppe. Diese Gruppe ist nach Element-IDs geordnet.
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
Parameter
- pbLowerBound
[in] Die geschlossene Untergrenze von Element-IDs für diese geordnete Gruppe. Um eine Untergrenze von 0 anzugeben, verwenden Sie NULL.
Rückgabewert
S_OK
SYNC_E_INVALID_OPERATION, wenn eine Gruppe bereits geöffnet ist oder wenn zuvor dem Batch eine leere Gruppe hinzugefügt wurde.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY, wenn das ISyncChangeBatchBase-Objekt mit IProviderSyncServices::DeserializeChangeBatch oder IProviderSyncServices::DeserializeFullEnumerationChangeBatch erstellt wurde oder wenn das Objekt ein ISyncFullEnumerationChangeBatch-Objekt ist und dem Batch bereits eine Gruppe hinzugefügt wurde.
SYNC_E_RANGE_OUT_OF_ORDER, wenn das Objekt ein ISyncFullEnumerationChangeBatch-Objekt ist und pbLowerBound größer als die ID der Untergrenze ist, die zum Erstellen des Batches verwendet wurde.
Hinweise
Elementänderungen, die dem Änderungsbatch nach dem Aufrufen dieser Methode hinzugefügt werden, werden der geöffneten Gruppe hinzugefügt. Elementänderungen, die einer geordneten Gruppe hinzugefügt werden, müssen in aufsteigender Reihenfolge nach Element-ID hinzugefügt werden.
Dem Änderungsbatch können erst Elementänderungen hinzugefügt werden, wenn eine Gruppe geöffnet ist.