ISyncChangeBatchBase::BeginOrderedGroup
打开变更批中的排序组。此组按项目 ID 排序。
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
参数
- pbLowerBound
[in] 此排序组的项 ID 的封闭下限。若要将下限指定为 0，请使用 NULL。
返回值
S_OK
如果某个组已经打开或者先前将某个空组添加到批中，则返回值为 SYNC_E_INVALID_OPERATION。
如果 ISyncChangeBatchBase 对象是使用 IProviderSyncServices::DeserializeChangeBatch 或 IProviderSyncServices::DeserializeFullEnumerationChangeBatch 创建的，或者如果对象是一个 ISyncFullEnumerationChangeBatch 对象且已经将某个组添加到了批中，则返回值为 SYNC_E_CHANGE_BATCH_IS_READ_ONLY。
如果对象是一个 ISyncFullEnumerationChangeBatch 对象且 pbLowerBound 大于用于创建批的下限 ID，则返回值为 SYNC_E_RANGE_OUT_OF_ORDER。
备注
将调用此方法后添加到变更批的项变更添加到打开的组中。必须按照项 ID 的递增顺序将项变更添加到排序组中。
只有先打开一个组，项变更才能添加到变更批中。