ISyncChangeBatchBase::BeginOrderedGroup
開啟變更批次中的已排序群組。這個群組會依據項目識別碼排序。
HRESULT BeginOrderedGroup(
const BYTE * pbLowerBound);
參數
- pbLowerBound
[in] 這個已排序群組之項目識別碼範圍的封閉下限。若要將下限指定為 0,請使用 NULL。
傳回值
S_OK
如果某個群組已經開啟,或者先前已將空群組加入到此批次,則為 SYNC_E_INVALID_OPERATION。
如果 ISyncChangeBatchBase 物件是使用 IProviderSyncServices::DeserializeChangeBatch 或 IProviderSyncServices::DeserializeFullEnumerationChangeBatch 建立的,或者此物件是 ISyncFullEnumerationChangeBatch 物件而且已經將某個群組加入到此批次,則為 SYNC_E_CHANGE_BATCH_IS_READ_ONLY。
如果此物件是 ISyncFullEnumerationChangeBatch 物件而且 pbLowerBound 大於用來建立此批次的下限識別碼,則為 SYNC_E_RANGE_OUT_OF_ORDER。
備註
呼叫這個方法之後加入至變更批次的項目變更會加入至開啟的群組。加入到已排序群組的項目變更依據項目識別碼以遞增順序加入。
開啟群組之前,項目變更無法加入至變更批次。